sqlite3_bind_*

int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*)); int sqlite3_bind_double(sqlite3_stmt*, int, double); int sqlite3_bind_int(sqlite3_stmt*, int, int); int sqlite3_bind_int64(sqlite3_stmt*, int, long long int); int sqlite3_bind_null(sqlite3_stmt*, int); int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*)); int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int n, void(*)(void*)); #define SQLITE_STATIC ((void(*)(void *))0) #define SQLITE_TRANSIENT ((void(*)(void *))-1)

В SQL выражении, передаваемом функциям sqlite3_prepare() и sqlite3_prepare16(), литералы могут быть заменены маской вида: '?' или ':AAA', где 'AAA' – идентификатор. Значения масок (также называемых host parameter names) могут быть связаны при помощи этих функций.

Первый аргумент – указатель на структуру sqlite3_stmt, возвращаемую функцией sqlite3_prepare(). Второй аргумент – порядковое значение маски в выражении. Маски нумеруются с 1.

Пятый аргумент, передаваемый функциям sqlite3_bind_blob(), sqlite3_bind_text() и sqlite3_bind_text16() – деструктор освобождающий BLOB или текст, после того, как SQLite завершил их использование. Если пятый аргумент равен SQLITE_STATIC, то библиотека предполагает, что данные статичные и их не надо освобождать, а если аргумент равен SQLITE_TRANSIENT, то библиотека сделает свою собственную копию данных.

Вызов sqlite3_bind_*() должен происходить до вызова sqlite3_prepare() или sqlite3_reset() и перед вызовом sqlite3_step(). Привязки значений не сбразываются при вызове sqlite3_reset(). Все неопределенные маски интерпритируются как NULL.