PDFium Delphi Component Docs

TextSnapshotCacheHitCount プロパティ

コンポーネント: TPdf  ·  ユニット: PDFium
保持されたページスナップショットから提供された、テキストスナップショット読み取りの回数を数えます

構文

property TextSnapshotCacheHitCount: Int64; // read only

説明

このカウンターは、ページがすでに有効なスナップショットを保持している TextPageSnapshot へのアクセス 1 回ごとに 1 ずつ増加します。ヒットすると、そのページスロットが least-recently-use 順で更新され、共有キャッシュガバナー内のエントリーに触れ、保持されたスナップショットのディープコピーが返されます

GetStructuredText や物理レイアウトの GetTextInReadingOrder といったコンシューマーは同じスナップショットを再利用するため、それらの繰り返し読み取りもヒットとしてここに現れます

この値は TPdf インスタンスの生存期間中累積し、リセットされることはありません

備考

読み取りはネイティブ PDFium ページアクセスが使用するレンダーロックによって保護されています

容量の変更、ページ編集、ドキュメントの再読み込み、クリアでもカウンターは保持されます。これらが変えるのは保持される内容であって、すでに起きたことではありません

返される値はすべてディープコピーであるため、ヒットによってキャッシュ済みの文字列や配列が呼び出し側の変更にさらされることはありません

Structured := Pdf.GetStructuredText(1, Options);
Structured := Pdf.GetStructuredText(1, Options);
// The second read is served by one cached snapshot

関連項目

TextSnapshotCacheMissCount, TextSnapshotCacheCount, TextSnapshotCacheCapacity, TextPageSnapshot, GetStructuredText