sqlite3_str_appendf(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
SQLITE3_STR_APPENDF(3)  NetBSD Library Functions Manual SQLITE3_STR_APPENDF(3)


NAME

     sqlite3_str_appendf, sqlite3_str_vappendf, sqlite3_str_append,
     sqlite3_str_appendall, sqlite3_str_appendchar, sqlite3_str_reset -- 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*);


DESCRIPTION

     These interfaces add 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 function-
     ality 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-ter-
     minated 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.

     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 subse-
     quent call to sqlite3_str_errcode(X).


IMPLEMENTATION NOTES

     These declarations were extracted from the interface documentation at
     line 8442.

     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*);


SEE ALSO

     sqlite3_str(3), sqlite3_str_new(3)

NetBSD 10.99                   January 24, 2024                   NetBSD 10.99