第20章 数据库函数库

1. 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 <stdlib.h>
       #include <stdio.h>
       #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”);
       }