Добавление содержимого в динамическую строку

void sqlite3_str_appendf(sqlite3_str*, const char *zFormat, ...);
void sqlite3_str_vappendf(sqlite3_str*, const char *zFormat, va_list);
void sqlite3_str_append(sqlite3_str*, const char *zIn, int N);
void sqlite3_str_appendall(sqlite3_str*, const char *zIn);
void sqlite3_str_appendchar(sqlite3_str*, int N, char C);
void sqlite3_str_reset(sqlite3_str*);

Эти интерфейсы добавляют содержимое в объект sqlite3_str, ранее полученный из sqlite3_str_new().

Интерфейсы sqlite3_str_appendf(X,F,...) и sqlite3_str_vappendf(X,F,V) используют встроенную функцию printf SQLite для добавления форматированного текста в конец объекта sqlite3_str X.

Метод sqlite3_str_append(X,S,N) добавляет ровно N байт из строки S в конец объекта sqlite3_str X. N должно быть неотрицательным. Строка S должна содержать как минимум N ненулевых байт. Для добавления нуль-терминированной строки целиком используйте метод sqlite3_str_appendall() вместо этого.

Метод sqlite3_str_appendall(X,S) добавляет все содержимое нуль-терминированной строки S в конец объекта sqlite3_str X.

Метод sqlite3_str_appendchar(X,N,C) добавляет N копий однобайтового символа C в конец объекта sqlite3_str X. Этот метод можно использовать, например, для добавления отступов.

Метод sqlite3_str_reset(X) сбрасывает строку, создаваемую внутри объекта sqlite3_str X, до нулевой длины.

Эти методы не возвращают код результата. Если произошла ошибка, этот факт записывается в объект sqlite3_str и может быть извлечён последующим вызовом sqlite3_str_errcode(X).

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