Legacy PDF 名称 token
THPDFNameObject.Value 和 legacy 字典键保留不带前导斜杠的 PDF 名称 token;已加载的解析器 token 里可能已经含有 #HH 转义
legacy 写入器先解码既有 token,再对所有保留字节、空白、控制字节和非 ASCII 的 UTF-8 字节编码;既有转义被规范化,不会二次转义
例如 token #41 表示 A,而 #2341 表示字面文本 #41;新编写的原始字节请先用 _PDFNameEncode 编码,再存入字面 hash 加两位十六进制数字
#GZ 之类的非法十六进制序列和结尾孤立的 hash 仍是字面数据,序列化时转义为 #23GZ 和 #23
前导与尾随空格保留为 #20,空名称仍是空 PDF 名称;数组、嵌套字典和字典键中的值使用相同的序列化规则
名称不是 PDF 文本字符串:写入器按字节保留,不转码调用方的源编码;新编写 Unicode 名称时请使用 UTF8Encode
全新的原生 XFA 构建器字典使用解码后的键,而名称值仍基于 token;适配器把这些解码键搬进 legacy 对象模型时必须编码一次