SQLiteC/C++接口详细介绍sqlite3_stmt类（三）

返回：SQLite---系列文章目录

上一篇：SQLiteC/C++接口详细介绍sqlite3_stmt类（二）-

下一篇：

1. sqlite3_bind_blob函数、 sqlite3_bind_blob64

sqlite3_bind_blob函数将二进制数据绑定到sqlite3_stmt对象中的SQL语句参数中。函数原型如下：

int sqlite3_bind_blob(
  sqlite3_stmt*,
  int,
  const void*,
  int n,
  void(*)(void*)
);

函数参数含义如下：

• 第一个参数是sqlite3_stmt对象的指针，表示由sqlite3_prepare_v2()函数编译的SQL语句。

• 第二个参数是要绑定的参数的索引，从1开始。

• 第三个参数是指向待绑定二进制数据的指针。

• 第四个参数是待绑定二进制数据的大小，以字节为单位。如果设置为-1，表示该函数自动根据传入的指针参数确定blob数据大小。

• 第五个参数是一个函数指针，用于在释放sqlite3_stmt对象前处理存放在其中的blob数据。

下面是一些使用sqlite3_bind_blob函数的示例：

sqlite3_stmt *stmt;
char buffer[10] = "hello";
sqlite3_prepare_v2(db, "INSERT INTO person (name, age) VALUES (?, ?)", -1, &stmt, NULL);
sqlite3_bind_blob(stmt, 1, buffer, 5, SQLITE_STATIC);
sqlite3_bind_blob(stmt, 2, buffer, -1, SQLITE_TRANSIENT);
sqlite3_step(stmt);
sqlite3_finalize(stmt);

该示例程序使用sqlite3_bind_blob函数向预处理的SQL语句中绑定了二进制数据，包括一个具有固定大小的缓冲区和一个动态大小的缓冲区。第一次绑定缓冲区大小为5，第二次绑定缓冲区大小为-1，表示使用传递的指针中指定的大小。

2、 sqlite3_bind_blob64函数

sqlite3_bind_blob64函数与sqlite3_bind_blob函数功能类似，但它允许传递更大的数据，因为它将数据大小作为64位整数传递。函数原型如下：

int sqlite3_bind_blob64(
  sqlite3_stmt*,
  int,
  const void*,
  sqlite3_uint64,
  void(*)(void*)
);

函数参数含义如下：

• 第一个参数是sqlite3_stmt对象的指针，表示由sqlite3_prepare_v2()函数编译的SQL语句。

• 第二个参数是要绑定的参数的索引，从1开始。

• 第三个参数是指向待绑定二进制数据的指针。

• 第四个参数是待绑定二进制数据的大小，以字节为单位。

• 第五个参数是一个函数指针，用于在释放sqlite3_stmt对象前处理存放在其中的blob数据。

下面是一个使用sqlite3_bind_blob64函数的示例：

sqlite3_stmt *stmt;
char buffer[1024] = "...";
sqlite3_prepare_v2(db, "INSERT INTO large_blob (data) VALUES (?)", -1, &stmt, NULL);
sqlite3_bind_blob64(stmt, 1, buffer, sizeof(buffer), SQLITE_STATIC);
sqlite3_step(stmt);
sqlite3_finalize(stmt);

该示例程序使用sqlite3_bind_blob64函数向预处理的SQL语句中绑定大量二进制数据，数据大小是1024字节，比sqlite3_bind_blob函数支持的最大值要大得多，能够处理任意大小的数据。

3. sqlite3_bind_double函数

sqlite3_bind_double函数用于将浮点数数据绑定到sqlite3_stmt对象中的SQL语句参数中。函数原型如下：

int sqlite3_bind_double(sqlite3_stmt*, int, double);

函数参数含义如下：

• 第一个参数是sqlite3_stmt对象的指针，表示由sqlite3_prepare_v2()函数编译的SQL语句。

• 第二个参数是要绑定的参数的索引，从1开始。

• 第三个参数是待绑定的浮点数。

下面是一些使用sqlite3_bind_double函数的示例：

sqlite3_stmt *stmt;
double score = 89.5;
sqlite3_prepare_v2(db, "INSERT INTO student (name, score) VALUES (?, ?)", -1, &stmt, NULL);
sqlite3_bind_double(stmt, 2, score);
sqlite3_step(stmt);
sqlite3_finalize(stmt);

该示例程序使用sqlite3_bind_double函数向预处理的SQL语句中绑定浮点数数据。

4. sqlite3_bind_int函数

sqlite3_bind_int函数用于将整数数据绑定到sqlite3_stmt对象中的SQL语句参数中。函数原型如下：

int sqlite3_bind_int(sqlite3_stmt*, int, int);

函数参数含义如下：

• 第一个参数是sqlite3_stmt对象的指针，表示由sqlite3_prepare_v2()函数编译的SQL语句。

• 第二个参数是要绑定的参数的索引，从1开始。

• 第三个参数是待绑定的整数。

下面是一些使用sqlite3_bind_int函数的示例：

sqlite3_stmt *stmt;
int age = 20;
sqlite3_prepare_v2(db, "INSERT INTO student (name, age) VALUES (?, ?)", -1, &stmt, NULL);
sqlite3_bind_int(stmt, 2, age);
sqlite3_step(stmt);
sqlite3_finalize(stmt);

该示例程序使用sqlite3_bind_int函数向预处理的SQL语句中绑定整数数据。

5. sqlite3_bind_int64函数

sqlite3_bind_int64函数用于将64位整数数据绑定到sqlite3_stmt对象中的SQL语句参数中。函数原型如下：

int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite3_int64);

函数参数含义如下：

• 第一个参数是sqlite3_stmt对象的指针，表示由sqlite3_prepare_v2()函数编译的SQL语句。

• 第二个参数是要绑定的参数的索引，从1开始。

• 第三个参数是待绑定的64位整数。

下面是一些使用sqlite3_bind_int64函数的示例：

sqlite3_stmt *stmt;
sqlite3_int64 salary = 50000;
sqlite3_prepare_v2(db, "INSERT INTO employee (name, salary) VALUES (?, ?)", -1, &stmt, NULL);
sqlite3_bind_int64(stmt, 2, salary);
sqlite3_step(stmt);
sqlite3_finalize(stmt);

该示例程序使用sqlite3_bind_int64函数向预处理的SQL语句中绑定64位整数数据。

6. sqlite3_bind_null函数

sqlite3_bind_null函数用于将空数据绑定到sqlite3_stmt对象中的SQL语句参数中。函数原型如下：

int sqlite3_bind_null(sqlite3_stmt*, int);

函数参数含义如下：

• 第一个参数是sqlite3_stmt对象的指针，表示由sqlite3_prepare_v2()函数编译的SQL语句。

• 第二个参数是要绑定的参数的索引，从1开始。

下面是一些使用sqlite3_bind_null函数的示例：

sqlite3_stmt *stmt;
sqlite3_prepare_v2(db, "INSERT INTO employee (name, type) VALUES (?, ?)", -1, &stmt, NULL);
sqlite3_bind_null(stmt, 2);
sqlite3_step(stmt);
sqlite3_finalize(stmt);

该示例程序使用sqlite3_bind_null函数向预处理的SQL语句中绑定空数据。在这个例子中，我们向employee表中插入了一个空数据。