Создание нового динамического объекта строки

sqlite3_str *sqlite3_str_new(sqlite3*);

Интерфейс sqlite3_str_new(D) выделяет и инициализирует новый объект sqlite3_str. Для предотвращения утечек памяти, объект, возвращаемый sqlite3_str_new(), должен быть освобожден последующим вызовом sqlite3_str_finish(X).

Интерфейс sqlite3_str_new(D) всегда возвращает указатель на допустимый объект sqlite3_str, хотя в случае ошибки выделения памяти возвращаемый объект может быть специальным синглтоном, который будет молча отклонять новый текст, всегда возвращать SQLITE_NOMEM из sqlite3_str_errcode(), всегда возвращать 0 для sqlite3_str_length() и всегда возвращать NULL из sqlite3_str_finish(X). Безопасно использовать значение, возвращенное sqlite3_str_new(D), как параметр sqlite3_str для любого из других методов sqlite3_str.

Параметр D для sqlite3_str_new(D) может быть NULL. Если параметр D в sqlite3_str_new(D) не равен NULL, то максимальная длина строки, содержащейся в объекте sqlite3_str, будет равна значению, установленному для sqlite3_limit(D,SQLITE_LIMIT_LENGTH), а не SQLITE_MAX_LENGTH.

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