Tokens de PDF name legados
THPDFNameObject.Value e chaves de dicionários legados retêm tokens de PDF name sem a barra inicial; tokens do parser carregado já podem conter escapes #HH
O writer legado decodifica um token existente e depois codifica todos os bytes reservados, whitespace, bytes de controle e bytes UTF-8 não ASCII; escapes existentes são canonificados sem escape duplo
Por exemplo, o token #41 denota A, enquanto #2341 denota o texto literal #41; codifique bytes raw recém-autorados com _PDFNameEncode antes de armazenar um hash literal seguido de dois dígitos hexadecimais
Sequências hex inválidas como #GZ e um hash final permanecem dados literais e são escapados como #23GZ e #23 durante a serialização
Espaços no início e no fim são preservados como #20, e o nome vazio continua sendo um PDF name vazio; valores em arrays, dicionários aninhados e chaves de dicionário usam as mesmas regras de serialização
Names não são PDF text strings: o writer preserva os bytes e não faz transcode da codificação de origem do chamador; use UTF8Encode ao fornecer names Unicode recém-autorados
Dicionários novos do builder nativo XFA usam chaves decodificadas, enquanto valores de name permanecem baseados em tokens; adapters devem codificar essas chaves decodificadas uma vez ao movê-las para o modelo de objetos legado