sqlite3_prepare

int sqlite3_prepare( sqlite3 *db, /* Database handle */ const char *zSql, /* SQL statement, UTF-8 encoded */ int nBytes, /* Length of zSql in bytes. */ sqlite3_stmt **ppStmt, /* OUT: Statement handle */ const char **pzTail /* OUT: Pointer to unused portion of zSql */ ); int sqlite3_prepare16( sqlite3 *db, /* Database handle */ const void *zSql, /* SQL statement, UTF-16 encoded */ int nBytes, /* Length of zSql in bytes. */ sqlite3_stmt **ppStmt, /* OUT: Statement handle */ const void **pzTail /* OUT: Pointer to unused portion of zSql */ );

Для исполнения SQL выражения в SQLite требуется откомпилировать его в байт-код при помощи этих функций. Единственное различие которых во втором параметре, являющемся SQL выражением в UTF-8 кодировке для sqlite3_prepare() и UTF-16 для sqlite3_prepare16().

Первый параметр “db” – хендл базы данных SQLite. Второй параметр “zSql” – SQL выражение, которое должно быть скомпилировано. Если nBytes меньше нуля то функция будет читать zSql до первого терминатора строки '\000', в случае если nBytes больше нуля это длина zSql в байтах (а не в символах).

*pzTail – указатель на следующий байт окончание первого SQL выражения в zSql. Эти функции обрабатывают только первое SQL выражение в zSql и после их вызова *pzTail укажет на следующее выражение которое было неоткомпилировано.