THotPDF.GetDocumentStringInternStatistics

返回与当前 PDF 加载关联的字符串池的存储与复用诊断信息

声明

function GetDocumentStringInternStatistics(
  out Statistics: THPDFDocumentStringInternStatistics): boolean;

返回值

文档字符串池可用期间返回 True，包括首次加载之前所有流量计数器都为零的时候

Admission limits

• MaxStringLength is 64 bytes
• MaxEntryCount is 65,536 distinct values
• MaxRetainedBytes 为 4 MiB 的字符串内容

空值、过长的值，以及会超出任一容量限制的新值，都会绕过字符串池，保留其原始字节

统计

• EntryCount 和 RetainedBytes 描述当前加载期间被纳入的值
• RequestCount equals HitCount plus MissCount plus BypassCount
• ReusedBytes counts bytes returned from existing entries
• NameRequestCount, OperatorRequestCount，以及 ShortStringRequestCount separate the three input categories
• 加载会话开始后 ResetCount 为 1，首次加载之前为零

Lifetime and matching

字符串池在每次加载开始时清空，按精确且区分大小写的字节匹配值，并且绝不会在多个 THotPDF 实例之间共享条目

池化的 AnsiString 值使用常规的引用计数和写时复制行为，因此之后的赋值或修改不会影响其他 PDF 对象

另请参阅： 可扩展加载, GetLastParserArenaStatistics, LoadFromStream, LoadFromRandomAccessSource