Tokens de nombres PDF legacy

THPDFNameObject.Value y las claves legacy de diccionarios retienen los tokens de nombres PDF sin la barra inicial; los tokens del parser cargado ya pueden contener escapes #HH

El escritor legacy decodifica un token existente y luego codifica todos los bytes reservados, whitespace, bytes de control y bytes UTF-8 no ASCII; los escapes existentes se canonicalizan sin doble escape

Por ejemplo, el token #41 denota A, mientras que #2341 denota el texto literal #41; codifique los bytes crudos recién escritos con _PDFNameEncode antes de almacenar un hash literal seguido de dos dígitos hexadecimales

Las secuencias hex inválidas como #GZ y un hash final permanecen como datos literales y se escapan como #23GZ y #23 durante la serialización

Los espacios iniciales y finales se preservan como #20, y el nombre vacío sigue siendo un nombre PDF vacío; los valores en arrays, diccionarios anidados y claves de diccionarios usan las mismas reglas de serialización

Los nombres no son text strings PDF: el escritor preserva los bytes y no transcodifica la encoding de origen del llamador; use UTF8Encode al suministrar nombres Unicode recién escritos

Los diccionarios recientes del builder nativo XFA usan claves decodificadas mientras que los valores de nombre permanecen basados en tokens; los adaptadores deben codificar esas claves decodificadas una vez al moverlas al modelo de objetos legacy