SQLITE3_STR_APPENDF(3)

NAME
sqlite3_str_appendf, sqlite3_str_vappendf, sqlite3_str_append, sqlite3_str_appendall, sqlite3_str_appendchar, sqlite3_str_reset, sqlite3_str_truncate - add content to a dynamic string

SYNOPSIS
#include <sqlite3.h>
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*);
void
sqlite3_str_truncate(sqlite3_str*, int N);

DESCRIPTION
These interfaces add or remove content to an sqlite3_str object previously obtained from sqlite3_str_new(). The sqlite3_str_appendf(X,F,...) and sqlite3_str_vappendf(X,F,V) interfaces uses the built-in printf functionality of SQLite to append formatted text onto the end of sqlite3_str object X.

The sqlite3_str_append(X,S,N) method appends exactly N bytes from string S onto the end of the sqlite3_str object X. N must be non-negative. S must contain at least N non-zero bytes of content. To append a zero-terminated string in its entirety, use the sqlite3_str_appendall() method instead.

The sqlite3_str_appendall(X,S) method appends the complete content of zero-terminated string S onto the end of sqlite3_str object X.

The sqlite3_str_appendchar(X,N,C) method appends N copies of the single-byte character C onto the end of sqlite3_str object X. This method can be used, for example, to add whitespace indentation.

The sqlite3_str_reset(X) method resets the string under construction inside sqlite3_str object X back to zero bytes in length.

The sqlite3_str_truncate(X,N) method changes the length of the string under construction to be N bytes or less. This routine is a no-op if N is negative or if the string is already N bytes or smaller in size.

These methods do not return a result code. If an error occurs, that fact is recorded in the sqlite3_str object and can be recovered by a subsequent call to sqlite3_str_errcode(X).

IMPLEMENTATION NOTES
These declarations were extracted from the interface documentation at line 8842.

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

SEE ALSO
sqlite3_str(3), sqlite3_str_new(3)