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 物件模型時必須編碼一次