c mysql数据库函数吗_Linux C MySQL数据库函数

1. 初始化一个连接句柄

MYSQL *mysql_init(MYSQL *);

正确：返回一个指向新分配的链接句柄结构的指针

错误：NULL

注：该函数的传入参数通常为NULL即可。

2. 建立物理连接

MYSQL *mysql_real_connect(MYSQL *connection,

const char *server_host,

const char *sql_user_name,

const char *sql_password,

const char *db_name,

unsigned int port_number,

const char *unix_socket_name,

unsigned int flags);

其中connection参数为通过mysql_init函数创建的句柄，server_host参数可为主机名或IP值，如果连到本机，我们仅仅只需指定“localhost”即可。sql_user_name和sql_password即为访问数据库的用户名和密码，如果sql_user_name为空，那么默认为当前Linux user的用户名，如果sql_password为空，那么只能访问不需要密码的数据。密码在经网络传输之前都经过加密处理。通常情况下，如果你没有改变MySQL的默认安装，port_number和*unix_socket_name的值分别为0和NULL即可，他们默认为当前相应值。flags参数允许我们改变当前使用协议的特性，默认情况下，置0即可。

如果连接不成功，该函数返回NULL

3. 断开连接

void mysql_close(MYSQL *connection);

使用该函数可以断开指定的链接。不让不需要的连接断开会浪费资源，但重新建立连接需要额外开销，在实际工作中我们可根据需要权衡。

4. 选项设置

int mysql_options(MYSQL *connection, enum option_to_set,

const char *argument);

该函数可用在mysql_init和mysql_real_connect之间来设置一些连接选项，option_to_set参数如MYSQL_OPT_CONNECT_TIMEOUT用来设置连接超时的时间(秒)，MYSQL_OPT_COMPRESS表示在网络传输中对数据进行压缩，而MYSQL_INIT_COMMAND指定每当连接建立时用来发送的命令。

函数成功时返回0，因为该函数仅仅用来设置选项，所以失败意味着使用了无效的选项。此外，该函数每次只能设置一种选项，所以每设置一个选项就必须调用该函数一次。

举例：

unsigned int timeout = 7;

connection = mysql_init(NULL);

ret = mysql_options(connection, MYSQL_OPT_CONNECT_TIMEOUT, (const char *)&timeout);

if (ret) {

/* Handle error */

...

}

connection = mysql_real_connect(connection ...

5. 错误处理

unsigned int mysql_errno(MYSQL *connection);

char *mysql_error(MYSQL *connection);

错误代码为非0值

举例：

if (mysql_errno(&my_connection)) {

fprintf(stderr, “Connection error %d: %s/n”, mysql_errno(&my_connection),

mysql_error(&my_connection));

6. 执行SQL命令

int mysql_query(MYSQL *connection, const char *query)

该函数用来执行SQL命令，如果执行成功则返回0。如果涉及二进制数据，可使用mysql_real_query这个函数

my_ulonglong mysql_affected_rows(MYSQL *connection);

该函数返回被update，insert，delete等查询命令影响的行数，返回值为unsigned Long(使用printf时需使用“lu"格式。当使用update命令时，该函数返回实际影响的行，而不是与where语句的匹配值(有些行已经是我们需要的那样，所以无需update)。如果我们希望该函数update的返回值与我们希望的那样，我们需要在mysql_real_connect函数中使用CLIENT_FOUND_ROWS flag，如

if (mysql_real_connect(&my_connection, “localhost”,

“rick”, “secret”, “foo”, 0, NULL, CLIENT_FOUND_ROWS)) {

此外，当我们使用delete命令删除整个表时，此函数返回0。

MySQL提供了LAST_INSERT_ID()函数来获取上次插入操作AUTO_INCREMENT列的数值，如SELECT LAST_INSERT_ID()；即可在mysql_query函数中使用该语句。

举例：

res = mysql_query(&my_connection, “SELECT LAST_INSERT_ID()”);

if (res) {

printf(“SELECT error: %s/n”, mysql_error(&my_connection));

} else {

res_ptr = mysql_use_result(&my_connection);

if (res_ptr) {

while ((sqlrow = mysql_fetch_row(res_ptr))) {

printf(“We inserted childno %s/n”, sqlrow[0]);

}

mysql_free_result(res_ptr);

}

7. 数据控制

MYSQL_RES *mysql_store_result(MYSQL *connection);

该函数成功时返回一个指向返回集的指针，否则返回NULL。

my_ulonglong mysql_num_rows(MYSQL_RES *result);

该函数获取返回集中的行数，若为0表示没有返回行。

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

该函数从mysql_store_result返回集中取出一行，当没有数据或者出差时返回NULL

void mysql_data_seek(MYSQL_RES *result, my_ulonglong offset);

该函数用于设置下一个被mysql_fetch_row取出的行，offset的值在0到rownum-1之间，当offset的值为0时，下一次用mysql_fetch_row取出的行就是返回集中的第一行。

MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result);

该函数用于获取返回集中当前指针的位置，并不是行数，所以不能与mysql_data_seek函数一 起使用

MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset);

该函数用于移动返回集中指针的位置并返回先前的位置

void mysql_free_result(MYSQL_RES *result);

该函数用于释放返回集。

MYSQL_RES *mysql_use_result(MYSQL *connection);

该函数并不像mysql_store_result那样将数据存储到返回集中，而是返回一个返回集对象指针，所以你必须返回使用mysql_fetch_row取回数据，这对于大的数据集来说可以减少客户端的存储空间。此外，先前的mysql_data_seek，mysql_row_tell，mysql_row_seek也不能在此使用，mysql_num_rows函数只有在所有数据都被检索出后才能为我所用。

8. 数据处理

unsigned int mysql_field_count(MYSQL *connection);

通常，该函数获取返回集中数据的列数。此外，我们还可以将该函数用于其它情况，比如说确定mysql_store_result函数失败的原因；如果mysql_store_result返回NULL，而mysql_filed_count返回了一个大于0的数，说明是检索错误，但如果mysql_field_count返回0，则表明为存储错误。

MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result);

该函数可获得与列字段相关信息的结构指针，包括如下等字段

char  *name   列的名字

char  *table   该列的表名，用于多表查询

enum enum_field_types type 列的类型

unsigned int length  列的宽度

unsigned int max_length;  mysql_store_result返回集中列的最大长度字节

unsigned int flags;  列的定义，包括NOT_NULL_FLAG, PRI_KEY_FLAG,

UNSIGNED_FLAG, AUTO_INCREMENT_FLAG, and

BINARY_FLAG.

unsigned int decimals;  小数点后的位数

常用的type有：

FIELD_TYPE_DECIMAL

FIELD_TYPE_LONG

FIELD_TYPE_STRING

FIELD_TYPE_VAR_STRING

宏IS_NUM当参数字段为数字类型的时候返回TRUE，如

if (IS_NUM(myslq_field_ptr->type)) printf(“Numeric type field/n”);

MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result,

MYSQL_FIELD_OFFSET offset);

设置mysql_fetch_field下一次取出列的位置，如果offset为0，下次将会取出第一列。

9. 获取系统信息

char *mysql_get_client_info(void);  返回客户端库文件的版本

char *mysql_get_host_info(MYSQL *connection); 返回服务器连接信息

char *mysql_get_server_info(MYSQL *connection);返回当前连接的服务器的信息

char *mysql_info(MYSQL*connection);.  返回最近一次执行的query的信息，但只对update和     insert有效

int mysql_select_db(MYSQL *connection,const char *dbname);改变当前连接的数据库，成功后返回0

int mysql_shutdown(MYSQL *connection); 关闭数据库服务器，成功后返回0，前提是你有改     权限。

10. 一个实例

#include

#include

#include “mysql.h”

MYSQL my_connection;

MYSQL_RES *res_ptr;

MYSQL_ROW sqlrow;

void display_header();

void display_row();

int main(int argc, char *argv[]) {

int res;

int first_row = 1;

mysql_init(&my_connection);

if (mysql_real_connect(&my_connection, “localhost”, “rick”,

“bar”, “rick”, 0, NULL, 0)) {

printf(“Connection success/n”);

res = mysql_query(&my_connection, “SELECT childno, fname,

age FROM children WHERE age > 5”);

if (res) {

fprintf(stderr, “SELECT error: %s/n”, mysql_error(&my_connection));

} else {

res_ptr = mysql_use_result(&my_connection);

if (res_ptr) {

display_header();

while ((sqlrow = mysql_fetch_row(res_ptr))) {

if (first_row) {

display_header();

first_row = 0;

}

display_row();

}

if (mysql_errno(&my_connection)) {

fprintf(stderr, “Retrive error: %s/n”,

mysql_error(&my_connection));

}

}

mysql_free_result(res_ptr);

}

mysql_close(&my_connection);

} else {

fprintf(stderr, “Connection failed/n”);

if (mysql_errno(&my_connection)) {

fprintf(stderr, “Connection error %d: %s/n”,

mysql_errno(&my_connection),

mysql_error(&my_connection));

}

}

return EXIT_SUCCESS;

}

void display_header()

{

MYSQL_FIELD *field_ptr;

printf(“Column details:/n”);

while ((field_ptr = mysql_fetch_field(res_ptr)) != NULL) {

printf(“/t Name: %s/n”, field_ptr->name);

printf(“/t Type: “);

if (IS_NUM(field_ptr->type)) {

printf(“Numeric field/n”);

} else {

switch(field_ptr->type) {

case FIELD_TYPE_VAR_STRING:

printf(“VARCHAR/n”);

break;

case FIELD_TYPE_LONG:

printf(“LONG/n”);

break;

default:

printf(“Type is %d, check in mysql_com.h/n”, field_ptr->type);

} /* switch */

} /* else */

printf(“/t Max width %ld/n”, field_ptr->length);

if (field_ptr->flags & AUTO_INCREMENT_FLAG)

printf(“/t Auto increments/n”);

printf(“/n”);

} /* while */

}

void display_row()     {  unsigned int field_count;  field_count = 0;  while (field_count < mysql_field_count(&my_connection)) {   if (sqlrow[field_count]) printf(“%s “, sqlrow[field_count]);   else printf(“NULL”);   field_count++;  }  printf(“/n”);     }