Чтение данных из BLOB-объекта по частям

Эта функция используется для чтения данных из открытого дескриптора BLOB в буфер, предоставленный вызывающей стороной. N байтов данных копируются в буфер Z из открытого BLOB, начиная с смещения iOffset.

Если смещение iOffset меньше, чем N байтов от конца BLOB, возвращается SQLITE_ERROR, и данные не читаются. Если N или iOffset меньше нуля, возвращается SQLITE_ERROR, и данные не читаются. Размер BLOB (а следовательно, и максимальное значение N+iOffset) можно определить с помощью интерфейса sqlite3_blob_bytes().

Попытка чтения из устаревшего дескриптора BLOB завершается ошибкой с кодом SQLITE_ABORT.

При успешном выполнении sqlite3_blob_read() возвращает SQLITE_OK. В противном случае возвращается код ошибки или расширенный код ошибки.

Эта процедура работает только с дескриптором BLOB, который был создан предыдущим успешным вызовом sqlite3_blob_open() и который не был закрыт функцией sqlite3_blob_close(). Передача любого другого указателя в эту процедуру приводит к неопределенному и, вероятно, нежелательному поведению.

См. также: sqlite3_blob_write().

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