From 18657a960e125336f704ea058e25c27bd3900dcb Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 19:28:19 +0200 Subject: Adding upstream version 3.40.1. Signed-off-by: Daniel Baumann --- www/c3ref/str_append.html | 163 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 163 insertions(+) create mode 100644 www/c3ref/str_append.html (limited to 'www/c3ref/str_append.html') diff --git a/www/c3ref/str_append.html b/www/c3ref/str_append.html new file mode 100644 index 0000000..b38da20 --- /dev/null +++ b/www/c3ref/str_append.html @@ -0,0 +1,163 @@ + + + + + +Add Content To A Dynamic String + + + +
+ + + +
+
+Small. Fast. Reliable.
Choose any three. +
+
+ +
+ +
+
+ + + +
+
+
+ + +
+

SQLite C Interface

 +

Add Content To A Dynamic String

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

+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 +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.

+ +

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). +

See also lists of + Objects, + Constants, and + Functions.

+ -- cgit v1.2.3