THotPDF.GetDocumentStringInternStatistics

傳回與目前 PDF 載入相關之字串池的儲存與重用診斷

宣告

function GetDocumentStringInternStatistics(
  out Statistics: THPDFDocumentStringInternStatistics): boolean;

傳回值

文件字串池可用期間傳回 True，包括第一次載入前所有流量計數器為零的狀態

准入限制

• MaxStringLength 為 64 位元組
• MaxEntryCount 為 65,536 個不同值
• MaxRetainedBytes 為 4 MiB 的字串內容

空值、超長值，以及會超出任一容量上限的新值都會繞過字串池，保留原始位元組

統計資料

• EntryCount 與 RetainedBytes 描述目前載入期間准入的值
• RequestCount 等於 HitCount 加 MissCount 加 BypassCount
• ReusedBytes 計算從既有項目傳回的位元組數
• NameRequestCount、OperatorRequestCount 與 ShortStringRequestCount 分開統計三類輸入
• ResetCount 在載入工作階段開始後為 1，第一次載入前為 0

生命週期與比對

字串池在每次載入開始時清空，以區分大小寫的精確位元組比對值，且絕不在 THotPDF 實例之間共享項目

池內的 AnsiString 值使用一般的參照計數與 copy-on-write 行為，後續的指派或修改不會影響另一個 PDF 物件

See also: 可縮放與隨機存取的 PDF 載入, GetLastParserArenaStatistics, LoadFromStream, LoadFromRandomAccessSource