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_new()获得的sqlite3_str对象。
所述sqlite3_str_appendf(X,F,...)和 sqlite3_str_vappendf(X,F,V)接口使用内置的printf 的SQLite的功能来格式化文本追加到的末尾 sqlite3_str对象X.
所述sqlite3_str_append(X,S,N)方法附加恰好从串S N字节到的端sqlite3_str对象X. N必须是非负的。S必须包含至少N个非零字节的内容。要完整地附加一个以零结尾的字符串,请改用sqlite3_str_appendall() 方法。
所述sqlite3_str_appendall(X,S)方法附加零终止的字符串S的完整内容到的端sqlite3_str对象X.
所述sqlite3_str_appendchar(X,N,C)方法追加单字节字符的C N份到的端sqlite3_str对象X.,可以使用此方法,例如,添加空格缩进。
所述sqlite3_str_reset(X)方法重置在建字符串里面sqlite3_str长度对象X回零个字节。
这些方法不返回结果代码。如果发生错误,则将该事实记录在sqlite3_str对象中,并且可以通过后续调用sqlite3_str_errcode(X)来恢复。