小巧、快速、可靠。
選擇其中三項。

SQLite C 介面

建立新的動態字串物件

sqlite3_str *sqlite3_str_new(sqlite3*);

sqlite3_str_new(D) 介面會配置並初始化一個新的 sqlite3_str 物件。為了避免記憶體洩漏,sqlite3_str_new() 返回的物件必須透過後續呼叫 sqlite3_str_finish(X) 來釋放。

sqlite3_str_new(D) 介面總是會返回一個指向有效 sqlite3_str 物件的指標,但在發生記憶體不足錯誤時,返回的物件可能是一個特殊的單例物件,它會靜默地拒絕新的文字,sqlite3_str_errcode() 總是返回 SQLITE_NOMEM,sqlite3_str_length() 總是返回 0,而 sqlite3_str_finish(X) 總是返回 NULL。將 sqlite3_str_new(D) 返回的值作為其他任何 sqlite3_str 方法的 sqlite3_str 參數使用總是安全的。

sqlite3_str_new(D) 的 D 參數可以是 NULL。如果 sqlite3_str_new(D) 中的 D 參數不是 NULL,則 sqlite3_str 物件中包含的字串的最大長度將是 sqlite3_limit(D,SQLITE_LIMIT_LENGTH) 的設定值,而不是 SQLITE_MAX_LENGTH

另請參閱 物件常數函式 列表。