Сравнение возрастов двух маркеров моментальных снимков

Сравнение возрастов двух маркеров моментальных снимков.

int sqlite3_snapshot_cmp(
  sqlite3_snapshot *p1,
  sqlite3_snapshot *p2
);

Интерфейс sqlite3_snapshot_cmp(P1, P2) используется для сравнения возрастов двух допустимых маркеров моментальных снимков.

Если два маркера моментальных снимков не связаны с одним и тем же файлом базы данных, результат сравнения не определен.

Кроме того, результат сравнения действителен только в том случае, если оба маркера моментальных снимков были получены с помощью вызова sqlite3_snapshot_get() с момента последнего удаления файла журнала WAL. Файл журнала WAL удаляется, когда база данных меняется на режим отката или когда количество клиентов базы данных уменьшается до нуля. Если любой из маркеров моментальных снимков был получен до последнего удаления файла журнала WAL, значение, возвращаемое этой функцией, не определено.

В противном случае этот API возвращает отрицательное значение, если P1 относится к более старому моментальному снимку, чем P2, ноль, если два маркера относятся к одному и тому же моментальному снимку базы данных, и положительное значение, если P1 является более новым моментальным снимком, чем P2.

Этот интерфейс доступен только если SQLite скомпилирован с опцией SQLITE_ENABLE_SNAPSHOT.

См. также списки Объектов, Констант и Функций.