GetXRefDiagnostics

Управление документами, диагностика, восстановление

Описание

Возвращает отчет JSON о перекрестных ссылках и пути восстановления, использованных при загрузке выбранного документа

Синтаксис

Delphi

Function TPDFlib.GetXRefDiagnostics: WideString;

Возвращаемые значения

Пустая строка	Нет выбранного загруженного документа, а `LastErrorCode` установлен в 401
Отчёт JSON	Отчет возвращен

Поля отчета

Позиции в файле	`fileSize`, `headerOffset`, `startXRefTokenOffset`, `declaredStartXRef`, `effectiveStartXRef`, `eofOffset` и `trailingBytes`
Сводка перекрестных ссылок	`policy` равно `strict`, `compatible` или `recovery`; `xrefType` равно `table`, `stream`, `hybrid`, `mixed` или `unknown`; `hasXRefStream`, `hybrid`, `shiftedHeader`, `sectionCount` и `trailerCount` описывают выбранную цепочку
Числа записей	`entries` сообщает выделенные слоты, а также свободные, используемые, сжатые и недопустимые записи
Решения	`decisions` сообщает выбранные типы цепочек, прослеженные ссылки, исправления совместимости и отклоненные разделы в порядке вычисления
Разделы	Каждый элемент сообщает объявленные и физические смещения, тип таблицы или потока, источник `startxref`, `prev` или `xrefstm`, включающие границы словаря trailer, связанные смещения, попытку разбора, `compatibilityFlags` и состояние успеха
Восстановление	`recovery` сообщает режим strict, repair или best-effort, предпринимался ли резервный вариант и увенчался ли он успехом, счетчики восстановленных объектов, источник trailer и упорядоченные решения

Примечания

Все позиции байтов отсчитываются от нуля; недоступные позиции сообщаются как -1Повтор со смещенным заголовком остается видимым как попытка 2, поэтому объявленные и фактические позиции можно сравнить, не скрывая неудавшейся первой попыткиРешения о восстановлении могут включать

raw-object-scan, recover-object-stream-members и synthesize-trailer