Small. Fast. Reliable.
Choose any three.

SQLite C接口

创建一个新的动态字符串对象

sqlite3_str * sqlite3_str_new(sqlite3 *);

所述sqlite3_str_new(d)接口分配和初始化一个新sqlite3_str对象。为避免内存泄漏,必须通过后续调用sqlite3_str_finish(X)来释放 sqlite3_str_new()返回的对象 。

sqlite3_str_new(d)接口总是返回一个指向一个有效的sqlite3_str对象,虽然在内存不足,错误的情况下返回的对象可能是一个特殊的单,将默默地拒绝新的文字,总是从返回SQLITE_NOMEM sqlite3_str_errcode(),对于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

另请参见 对象常量函数的列表