Статус динамической последовательности

int sqlite3_str_errcode(sqlite3_str*);
int sqlite3_str_length(sqlite3_str*);
char *sqlite3_str_value(sqlite3_str*);

Эти интерфейсы возвращают текущий статус объекта sqlite3_str.

Если какие-либо предшествующие ошибки произошли, строя динамическую последовательность в sqlite3_str X, метод sqlite3_str_errcode(X) возвратит соответствующий код ошибки. Метод sqlite3_str_errcode(X) вернет SQLITE_NOMEM после любой ошибки памяти, SQLITE_TOOBIG, если размер динамической последовательности превышает SQLITE_MAX_LENGTH, или SQLITE_OK, если все в порядке.

Метод sqlite3_str_length(X) возвращает текущую длину в байтах динамической последовательности в процессе строительства в объекте sqlite3_str X. Длина, возвращенная sqlite3_str_length(X), не включает байт нулевого завершения.

Метод sqlite3_str_value(X) возвращает указатель на текущее содержание динамической последовательности в процессе строительства в X. Значение, возвращенное sqlite3_str_value(X), управляет объектом sqlite3_str X и может быть освобождено или изменено любым последующим методом на том же самом объекте sqlite3_str. Запросы не должны использовать указатель, возвращенный sqlite3_str_value(X), после любого последующего вызова метода на том же самом объекте. Запросы могут изменить содержание последовательности, возвращенной sqlite3_str_value(X), пока они не пишут ни в какие байты вне диапазона от 0 до sqlite3_str_length(X) и не читают или пишут любой байт после любого последующего вызова метода sqlite3_str.