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”);
    }

你可能感兴趣的:(Linux/Unix,学习,mysql,数据库,linux,c,null,insert)