程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 數據庫知識 >> MYSQL數據庫 >> MySQL綜合教程 >> 搞定linux上MySQL編程(六):C語言編寫MySQL程序(結)

搞定linux上MySQL編程(六):C語言編寫MySQL程序(結)

編輯:MySQL綜合教程

搞定linux上MySQL編程(六):C語言編寫MySQL程序(結)


在實際應用中,我們不可能在命令行登錄進數據庫進行數據的查詢、插入等操作,用戶一般是使用一個界面良好的應用程序軟件來對數據進行管理。為了方便應用程序的開發,MySQL提供了多種編程語言(C、perl、php等)的編程接口,供開發者使用。 對於C語言來說,MySQL提供了C語言客戶機庫,它允許從任何C程序的內部訪問MySQL數據庫,客戶機實現API,API定義了客戶機如何建立和執行與服務器的通信。使用C語言開發MySQL項目具有更好的安全性和性能,C語言API是與MySQL一起提供的,包含在mysqlclient庫文件中,用於連接和執行數據庫查詢。 首先看一下MySQL為C語言操作定義的數據類型。 1. MYSQL,MYSQL結構代表一個數據庫連接句柄,包含有關服務器的連接狀態的信息,幾乎所有函數都是用到它。其定 義如下:
typedef struct st_mysql
{
  NET           net;                    /* Communication parameters */
  unsigned char *connector_fd;          /* ConnectorFd for SSL */
  char          *host,*user,*passwd,*unix_socket,*server_version,*host_info;
  char          *info, *db;
  struct charset_info_st *charset;
  MYSQL_FIELD   *fields;
  MEM_ROOT      field_alloc;
  my_ulonglong affected_rows;
  my_ulonglong insert_id;               /* id if insert on table with NEXTNR */
  my_ulonglong extra_info;              /* Not used */
  unsigned long thread_id;              /* Id for connection in server */
  unsigned long packet_length;
  unsigned int  port;
  unsigned long client_flag,server_capabilities;
  unsigned int  protocol_version;
  unsigned int  field_count;
  unsigned int  server_status;
  unsigned int  server_language;
  unsigned int  warning_count;
  struct st_mysql_options options;
  enum mysql_status status;
  my_bool       free_me;                /* If free in mysql_close */
  my_bool       reconnect;              /* set to 1 if automatic reconnect */

  /* session-wide random string */
  char          scramble[SCRAMBLE_LENGTH+1];

 /*
   Set if this is the original connection, not a master or a slave we have
   added though mysql_rpl_probe() or mysql_set_master()/ mysql_add_slave()
 */
  my_bool rpl_pivot;
  /*
    Pointers to the master, and the next slave connections, points to
    itself if lone connection.
  */
  struct st_mysql* master, *next_slave;

  struct st_mysql* last_used_slave; /* needed for round-robin slave pick */
 /* needed for send/read/store/use result to work correctly with replication */
  struct st_mysql* last_used_con;

  LIST  *stmts;                     /* list of all statements */
  const struct st_mysql_methods *methods;
  void *thd;
  /*
    Points to boolean flag in MYSQL_RES  or MYSQL_STMT. We set this flag
    from mysql_stmt_close if close had to cancel result set of this object.
  */
  my_bool *unbuffered_fetch_owner;
  /* needed for embedded server - no net buffer to store the 'info' */
  char *info_buffer;
  void *extension;
} MYSQL;
2. MYSQL_RES MYSQL_RES結構代表返回行的查詢結果(SELECT、SHOW、DESCRIBE等),從數據庫讀取數據,最後就是從MYSQL_RES中讀取數據。 MYSQL_RES定義如下:
typedef struct st_mysql_res {
  my_ulonglong  row_count;
  MYSQL_FIELD   *fields;
  MYSQL_DATA    *data;
  MYSQL_ROWS    *data_cursor;
  unsigned long *lengths;               /* column lengths of current row */
  MYSQL         *handle;                /* for unbuffered reads */
  const struct st_mysql_methods *methods;
  MYSQL_ROW     row;                    /* If unbuffered read */
  MYSQL_ROW     current_row;            /* buffer to current row */
  MEM_ROOT      field_alloc;
  unsigned int  field_count, current_field;
  my_bool       eof;                    /* Used by mysql_fetch_row */
  /* mysql_stmt_close() had to cancel this result */
  my_bool       unbuffered_fetch_cancelled;  
  void *extension;
} MYSQL_RES;
MySQL 有如下C語言API:

函數

描述

mysql_affected_rows()

返回上次UPDATE、DELETE或INSERT查詢更改/刪除/插入的行數。

mysql_autocommit()

切換 autocommit模式,ON/OFF

mysql_change_user()

更改打開連接上的用戶和數據庫。

mysql_charset_name()

返回用於連接的默認字符集的名稱。

mysql_close()

關閉服務器連接。

mysql_commit()

提交事務。

mysql_connect()

連接到MySQL服務器。該函數已不再被重視,使用mysql_real_connect()取代。

mysql_create_db()

創建數據庫。該函數已不再被重視,使用SQL語句CREATE DATABASE取而代之。

mysql_data_seek()

在查詢結果集中查找屬性行編號。

mysql_debug()

用給定的字符串執行DBUG_PUSH。

mysql_drop_db()

撤銷數據庫。該函數已不再被重視,使用SQL語句DROP DATABASE取而代之。

mysql_dump_debug_info()

讓服務器將調試信息寫入日志。

mysql_eof()

確定是否讀取了結果集的最後一行。該函數已不再被重視,可以使用mysql_errno()或mysql_error()取而代之。

mysql_errno()

返回上次調用的MySQL函數的錯誤編號。

mysql_error()

返回上次調用的MySQL函數的錯誤消息。

mysql_escape_string()

為了用在SQL語句中,對特殊字符進行轉義處理。

mysql_fetch_field()

返回下一個表字段的類型。

mysql_fetch_field_direct()

給定字段編號,返回表字段的類型。

mysql_fetch_fields()

返回所有字段結構的數組。

mysql_fetch_lengths()

返回當前行中所有列的長度。

mysql_fetch_row()

從結果集中獲取下一行

mysql_field_seek()

將列光標置於指定的列。

mysql_field_count()

返回上次執行語句的結果列的數目。

mysql_field_tell()

返回上次mysql_fetch_field()所使用字段光標的位置。

mysql_free_result()

釋放結果集使用的內存。

mysql_get_client_info()

以字符串形式返回客戶端版本信息。

mysql_get_client_version()

以整數形式返回客戶端版本信息。

mysql_get_host_info()

返回描述連接的字符串。

mysql_get_server_version()

以整數形式返回服務器的版本號。

mysql_get_proto_info()

返回連接所使用的協議版本。

mysql_get_server_info()

返回服務器的版本號。

mysql_info()

返回關於最近所執行查詢的信息。

mysql_init()

獲取或初始化MYSQL結構。

mysql_insert_id()

返回上一個查詢為AUTO_INCREMENT列生成的ID。

mysql_kill()

殺死給定的線程。

mysql_library_end()

最終確定MySQL C API庫。

mysql_library_init()

初始化MySQL C API庫。

mysql_list_dbs()

返回與簡單正則表達式匹配的數據庫名稱。

mysql_list_fields()

返回與簡單正則表達式匹配的字段名稱。

mysql_list_processes()

返回當前服務器線程的列表。

mysql_list_tables()

返回與簡單正則表達式匹配的表名。

mysql_more_results()

檢查是否還存在其他結果。

mysql_next_result()

在多語句執行過程中返回/初始化下一個結果。

mysql_num_fields()

返回結果集中的列數。

mysql_num_rows()

返回結果集中的行數。

mysql_options()

為mysql_connect()設置連接選項。

mysql_ping()

檢查與服務器的連接是否工作,如有必要重新連接。

mysql_query()

執行指定為“以Null終結的字符串”的SQL查詢。

mysql_real_connect()

連接到MySQL服務器。

mysql_real_escape_string()

考慮到連接的當前字符集,為了在SQL語句中使用,對字符串中的特殊字符進行轉義處理。

mysql_real_query()

執行指定為計數字符串的SQL查詢。

mysql_refresh()

刷新或復位表和高速緩沖。

mysql_reload()

通知服務器再次加載授權表。

mysql_rollback()

回滾事務。

mysql_row_seek()

使用從mysql_row_tell()返回的值,查找結果集中的行偏移。

mysql_row_tell()

返回行光標位置。

mysql_select_db()

選擇數據庫。

mysql_server_end()

最終確定嵌入式服務器庫。

mysql_server_init()

初始化嵌入式服務器庫。

mysql_set_server_option()

為連接設置選項(如多語句)。

mysql_sqlstate()

返回關於上一個錯誤的SQLSTATE錯誤代碼。

mysql_shutdown()

關閉數據庫服務器。

mysql_stat()

以字符串形式返回服務器狀態。

mysql_store_result()

檢索完整的結果集至客戶端。

mysql_thread_id()

返回當前線程ID。

mysql_thread_safe()

如果客戶端已編譯為線程安全的,返回1。

mysql_use_result()

初始化逐行的結果集檢索。

mysql_warning_count()

返回上一個SQL語句的告警數。

與MySQL交互時,應用程序應使用該一般性原則:

1. 通過調用mysql_library_init(),初始化MySQL庫。庫可以是mysqlclient C客戶端庫,或mysqld嵌入式服務器庫,具體情況取決於應用程序是否與“-libmysqlclient”或“-libmysqld”標志鏈接。

2. 通過調用mysql_init()初始化連接處理程序,並通過調用mysql_real_connect()連接到服務器。

3. 發出SQL語句並處理其結果。(在下面的討論中,詳細介紹了使用它的方法)。

4. 通過調用mysql_close(),關閉與MySQL服務器的連接。

5. 通過調用mysql_library_end(),結束MySQL庫的使用。

 

調用mysql_library_init()和mysql_library_end()的目的在於,為MySQL庫提供恰當的初始化和結束處理。對於與客戶端庫鏈接的應用程序,它們提供了改進的內存管理功能。如果不調用mysql_library_end(),內存塊仍將保持分配狀態(這不會增加應用程序使用的內存量,但某些內存洩漏檢測器將抗議它)。對於與嵌入式服務器鏈接的應用程序,這些調用會啟動並停止服務器。

mysql_library_init()和mysql_library_end()實際上是#define符號,這類符號使得它們等效於mysql_server_init()和mysql_server_end(),但其名稱更清楚地指明,無論應用程序使用的是mysqlclient或mysqld庫,啟動或結束MySQL庫時,應調用它們。對於早期的MySQL版本,可調用mysql_server_init()和mysql_server_end()取而代之。

如果願意,可省略對mysql_library_init()的調用,這是因為,必要時,mysql_init()會自動調用它。

要想連接到服務器,可調用mysql_init()來初始化連接處理程序,然後用該處理程序(以及其他信息,如主機名、用戶名和密碼)調用mysql_real_connect()。建立連接後,在低於5.0.3版的API中,mysql_real_connect()會將再連接標志(MYSQL結構的一部分)設置為1,或在較新的版本中,將其設置為0。對於該標志,值“1”指明,如果因連接丟失而無法執行語句,放棄之前,會嘗試再次連接到服務器。從MySQL 5.0.13開始,可以在mysql_options()上使用MYSQL_OPT_RECONNECT選項,以控制再連接行為。完成連接後,調用mysql_close()中止它。

當連接處於活動狀態時,客戶端或許會使用mysql_query()或mysql_real_query()向服務器發出SQL查詢。兩者的差別在於,mysql_query()預期的查詢為指定的、由Null終結的字符串,而myql_real_query()預期的是計數字符串。如果字符串包含二進制數據(其中可能包含Null字節),就必須使用mysql_real_squery()。

對於每個非SELECT查詢(例如INSERT、UPDATE、DELETE),通過調用mysql_affected_rows(),可發現有多少行已被改變(影響)。

對於SELECT查詢,能夠檢索作為結果集的行。注意,某些語句因其返回行,類似與SELECT。包括SHOW、DESCRIBE和EXPLAIN。應按照對待SELECT語句的方式處理它們。

客戶端處理結果集的方式有兩種。一種方式是,通過調用mysql_store_result(),一次性地檢索整個結果集。該函數能從服務器獲得查詢返回的所有行,並將它們保存在客戶端。第二種方式是針對客戶端的,通過調用mysql_use_result(),對“按行”結果集檢索進行初始化處理。該函數能初始化檢索結果,但不能從服務器獲得任何實際行。

在這兩種情況下,均能通過調用mysql_fetch_row()訪問行。通過mysql_store_result(),mysql_fetch_row()能夠訪問以前從服務器獲得的行。通過mysql_use_result(),mysql_fetch_row()能夠實際地檢索來自服務器的行。通過調用mysql_fetch_lengths(),能獲得關於各行中數據大小的信息。

完成結果集操作後,請調用mysql_free_result()釋放結果集使用的內存。

這兩種檢索機制是互補的。客戶端程序應選擇最能滿足其要求的方法。實際上,客戶端最常使用的是mysql_store_result()。

mysql_store_result()的1個優點在於,由於將行全部提取到了客戶端上,你不僅能連續訪問行,還能使用mysql_data_seek()或mysql_row_seek()在結果集中向前或向後移動,以更改結果集內當前行的位置。通過調用mysql_num_rows(),還能發現有多少行。另一方面,對於大的結果集,mysql_store_result()所需的內存可能會很大,你很可能遇到內存溢出狀況。

mysql_use_result()的1個優點在於,客戶端所需的用於結果集的內存較少,原因在於,一次它僅維護一行(由於分配開銷較低,mysql_use_result()能更快)。它的缺點在於,你必須快速處理每一行以避免妨礙服務器,你不能隨機訪問結果集中的行(只能連續訪問行),你不知道結果集中有多少行,直至全部檢索了它們為止。不僅如此,即使在檢索過程中你判定已找到所尋找的信息,也必須檢索所有的行。

通過API,客戶端能夠恰當地對查詢作出響應(僅在必要時檢索行),而無需知道查詢是否是SELECT查詢。可以在每次mysql_query()或mysql_real_query()後,通過調用mysql_store_result()完成該操作。如果結果集調用成功,查詢為SELECT,而且能夠讀取行。如果結果集調用失敗,可調用mysql_field_count()來判斷結果是否的確是所預期的。如果mysql_field_count()返回0,查詢不返回數據(表明它是INSERT、UPDATE、DELETE等),而且不返回行。如果mysql_field_count()是非0值,查詢應返回行,但沒有返回行。這表明查詢是失敗了的SELECT。關於如何實現該操作的示例,請參見關於mysql_field_count()的介紹。

無論是mysql_store_result()還是mysql_use_result(),均允許你獲取關於構成結果集的字段的信息(字段數目,它們的名稱和類型等)。通過重復調用mysql_fetch_field(),可以按順序訪問行內的字段信息,或者,通過調用mysql_fetch_field_direct(),能夠在行內按字段編號訪問字段信息。通過調用mysql_field_seek(),可以改變當前字段的光標位置。對字段光標的設置將影響後續的mysql_fetch_field()調用。此外,你也能通過調用mysql_fetch_fields(),一次性地獲得關於字段的所有信息。

為了檢測和通報錯誤,MySQL提供了使用mysql_errno()和mysql_error()函數訪問錯誤信息的機制。它們能返回關於最近調用的函數的錯誤代碼或錯誤消息,最近調用的函數可能成功也可能失敗,這樣,你就能判斷錯誤是在何時出現的,以及錯誤是什麼。


1.連接mysql數據庫示例:
#include 
#include 

int main(int argc, const char *argv[])
{
    MYSQL   mysql;

    if (NULL == mysql_init(&mysql)) {    //分配和初始化MYSQL對象
        printf("mysql_init(): %s\n", mysql_error(&mysql));
        return -1;
    }

    //嘗試與運行在主機上的MySQL數據庫引擎建立連接
    if (NULL == mysql_real_connect(&mysql,
                "localhost",
                "root",
                "shallnet",
                "db_users",
                0,
                NULL,
                0)) {
        printf("mysql_real_connect(): %s\n", mysql_error(&mysql));
        return -1;
    }

    printf("Connected MySQL successful! \n");

    mysql_close(&mysql);
    return 0;
}
上例中使用函數說明:

MYSQL *mysql_init(MYSQL *mysql) , 分配或初始化與mysql_real_connect()相適應的MYSQL對象。如果mysql是NULL指針,該函數將分配、初始化、並返回新對象。否則,將初始化對象,並返回對象的地址。如果mysql_init()分配了新的對象,當調用mysql_close()來關閉連接時。將釋放該對象。函數返回初始化的MYSQL*句柄。如果無足夠內存以分配新的對象,返回NULL。

 

MYSQL *mysql_real_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd, const char *db, unsigned int port, const char *unix_socket, unsigned long client_flag)

 

mysql_real_connect()嘗試與運行在主機上的MySQL數據庫引擎建立連接。在你能夠執行需要有效MySQL連接句柄結構的任何其他API函數之前,mysql_real_connect()必須成功完成。

 

第一個參數mysql應是已有MYSQL結構的地址。

 

“host”的值必須是主機名或IP地址。如果“host”是NULL或字符串"localhost",連接將被視為與本地主機的連接。

 

“passwd”參數包含用戶的密碼。如果“passwd”是NULL,僅會對該用戶的(擁有1個空密碼字段的)用戶表中的條目進行匹配檢查。這樣,數據庫管理員就能按特定的方式設置MySQL權限系統,根據用戶是否擁有指定的密碼,用戶將獲得不同的權限。

“db”是數據庫名稱。如果db為NULL,連接會將默認的數據庫設為該值。

 

如果“port”不是0,其值將用作TCP/IP連接的端口號。注意,“host”參數決定了連接的類型。

 

如果unix_socket不是NULL,該字符串描述了應使用的套接字或命名管道。注意,“host”參數決定了連接的類型。

 

 

client_flag的值通常為0,但是,也能將其設置為下述標志的組合,以允許特定功能:

標志名稱

標志描述

CLIENT_COMPRESS

使用壓縮協議。

CLIENT_FOUND_ROWS

返回發現的行數(匹配的),而不是受影響的行數。

CLIENT_IGNORE_SPACE

允許在函數名後使用空格。使所有的函數名成為保留字。

CLIENT_INTERACTIVE

關閉連接之前,允許interactive_timeout(取代了wait_timeout)秒的不活動時間。客戶端的會話wait_timeout變量被設為會話interactive_timeout變量的值。

CLIENT_LOCAL_FILES

允許LOAD DATA LOCAL處理功能。

CLIENT_MULTI_STATEMENTS

通知服務器,客戶端可能在單個字符串內發送多條語句(由‘;’隔開)。如果未設置該標志,將禁止多語句執行。

CLIENT_MULTI_RESULTS

通知服務器,客戶端能夠處理來自多語句執行或存儲程序的多個結果集。如果設置了CLIENT_MULTI_STATEMENTS,將自動設置它。

CLIENT_NO_SCHEMA

禁止db_name.tbl_name.col_name語法。它用於ODBC。如果使用了該語法,它會使分析程序生成錯誤,在捕獲某些ODBC程序中的缺陷時,它很有用。

CLIENT_ODBC

客戶端是ODBC客戶端。它將mysqld變得更為ODBC友好。

CLIENT_SSL

使用SSL(加密協議)。該選項不應由應用程序設置,它是在客戶端庫內部設置的。

 

如果連接成功,函數返回MYSQL*連接句柄。如果連接失敗,返回NULL。對於成功的連接,返回值與第1個參數的值相同。

 

const char *mysql_error(MYSQL *mysql);

對於由mysql指定的連接,對於失敗的最近調用的API函數,mysql_error()返回包含錯誤消息的、由Null終結的字符串。如果該函數未失敗,mysql_error()的返回值可能是以前的錯誤,或指明無錯誤的空字符串。

經驗規則是,如果成功,所有向服務器請求信息的函數均會復位mysql_error()。

下面為編譯和執行結果輸出:

 

# make
cc -Wall -Werror -O2 -I/usr/include/mysql/   -c -o main.o main.c
Linking target_bin...
# ./target_bin 
Connected MySQL successful!

 

如果故意改錯密碼,編譯鏈接之後程序輸出如下信息:

 

# ./target_bin
mysql_real_connect(): Access denied for user 'root'@'localhost' (using password: YES)
2.查詢數據庫示例:

 

#include 
#include 
#include 
int main(int argc, const char *argv[])
{
    MYSQL           mysql;
    MYSQL_RES       *res = NULL;
    MYSQL_ROW       row;
    char            *query_str = NULL;
    int             rc, i, fields;
    int             rows;
    if (NULL == mysql_init(&mysql)) {
        printf("mysql_init(): %s\n", mysql_error(&mysql));
        return -1;
    }
    if (NULL == mysql_real_connect(&mysql,
                "localhost",
                "root",
                "shallnet",
                "db_users",
                0,
                NULL,
                0)) {
        printf("mysql_real_connect(): %s\n", mysql_error(&mysql));
        return -1;
    }
    printf("1. Connected MySQL successful! \n");
    query_str = "select * from tb_users";
    rc = mysql_real_query(&mysql, query_str, strlen(query_str));
    if (0 != rc) {
        printf("mysql_real_query(): %s\n", mysql_error(&mysql));
        return -1;
    }
    res = mysql_store_result(&mysql);
    if (NULL == res) {
         printf("mysql_restore_result(): %s\n", mysql_error(&mysql));
         return -1;
    }
    rows = mysql_num_rows(res);
    printf("The total rows is: %d\n", rows);
    fields = mysql_num_fields(res);
    printf("The total fields is: %d\n", fields);
    while ((row = mysql_fetch_row(res))) {
        for (i = 0; i < fields; i++) {
            printf("%s\t", row[i]);
        }
        printf("\n");
    }
    mysql_close(&mysql);
    return 0;
}
int mysql_real_query(MYSQL *mysql, const char *query, unsigned long length)

執行由“query”指向的SQL查詢,它應是字符串長度字節“long”。正常情況下,字符串必須包含1條SQL語句,而且不應為語句添加終結分號(‘;’)或“\g”。如果允許多語句執行,字符串可包含由分號隔開的多條語句。

對於包含二進制數據的查詢,必須使用mysql_real_query()而不是mysql_query(),這是因為,二進制數據可能會包含‘\0’字符。此外,mysql_real_query()比mysql_query()快,這是因為它不會在查詢字符串上調用strlen()。如果查詢成功,函數返回0。如果出現錯誤,函數返回非0值。

MYSQL_RES *mysql_store_result(MYSQL *mysql)

對於成功檢索了數據的每個查詢(SELECT、SHOW、DESCRIBE、EXPLAIN、CHECK TABLE等),必須調用mysql_store_result()或mysql_use_result()。

對於其他查詢,不需要調用mysql_store_result()或mysql_use_result(),但是如果在任何情況下均調用了mysql_store_result(),它也不會導致任何傷害或性能降低。通過檢查mysql_store_result()是否返回0,可檢測查詢是否沒有結果集(以後會更多)。

如果希望了解查詢是否應返回結果集,可使用mysql_field_count()進行檢查。mysql_store_result()將查詢的全部結果讀取到客戶端,分配1個MYSQL_RES結構,並將結果置於該結構中。如果查詢未返回結果集,mysql_store_result()將返回Null指針(例如,如果查詢是INSERT語句)。

如果讀取結果集失敗,mysql_store_result()還會返回Null指針。通過檢查mysql_error()是否返回非空字符串,mysql_errno()是否返回非0值,或mysql_field_count()是否返回0,可以檢查是否出現了錯誤。如果未返回行,將返回空的結果集。(空結果集設置不同於作為返回值的空指針)。

一旦調用了mysql_store_result()並獲得了不是Null指針的結果,可調用mysql_num_rows()來找出結果集中的行數。

可以調用mysql_fetch_row()來獲取結果集中的行,或調用mysql_row_seek()和mysql_row_tell()來獲取或設置結果集中的當前行位置。

一旦完成了對結果集的操作,必須調用mysql_free_result()。

返回具有多個結果的MYSQL_RES結果集合。如果出現錯誤,返回NULL。

my_ulonglong mysql_num_rows(MYSQL_RES *result)

函數返回結果集中的行數,mysql_num_rows()的使用取決於是否采用了mysql_store_result()或mysql_use_result()來返回結果集。如果使用了mysql_store_result(),可以立刻調用mysql_num_rows()。如果使用了mysql_use_result(),mysql_num_rows()不返回正確的值,直至檢索了結果集中的所有行為止,函數結果集中的行數。

unsigned int mysql_num_fields(MYSQL_RES *result)

要想傳遞MYSQL*參量取而代之,請使用無符號整數mysql_field_count(MYSQL *mysql)。

函數返回結果集中的列數。注意,你可以從指向結果集的指針或指向連接句柄的指針獲得行數。如果mysql_store_result()或mysql_use_result()返回NULL,應使用連接句柄(因而沒有結果集指針)。在該情況下,可調用mysql_field_count()來判斷mysql_store_result()是否生成了非空結果。這樣,客戶端程序就能采取恰當的行動,而不需要知道查詢是否是SELECT語句(或類似SELECT的語句)。

 

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

檢索結果集的下一行。在mysql_store_result()之後使用時,如果沒有要檢索的行,mysql_fetch_row()返回NULL。在mysql_use_result()之後使用時,如果沒有要檢索的行或出現了錯誤,mysql_fetch_row()返回NULL。

行內值的數目由mysql_num_fields(result)給出。如果行中保存了調用mysql_fetch_row()返回的值,將按照row[0]到row[mysql_num_fields(result)-1],訪問這些值的指針。行中的NULL值由NULL指針指明。

可以通過調用mysql_fetch_lengths()來獲得行中字段值的長度。對於空字段以及包含NULL的字段,長度為0。通過檢查字段值的指針,能夠區分它們。如果指針為NULL,字段為NULL,否則字段為空。

函數返回下一行的MYSQL_ROW結構。如果沒有更多要檢索的行或出現了錯誤,返回NULL。

void mysql_free_result(MYSQL_RES *result)

該函數釋放由mysql_store_result()、mysql_use_result()、mysql_list_dbs()等為結果集分配的內存。完成對結果集的操作後,必須調用mysql_free_result()釋放結果集使用的內存。

釋放完成後,不要嘗試訪問結果集。

編譯鏈接執行結果如下:

 

# make
cc -Wall -Werror -O2 -I/usr/include/mysql/   -c -o main.o main.c
Linking target_bin...
# ./target_bin 
1. Connected MySQL successful! 
The total rows is: 13
The total fields is: 3
10000   Allen   1981-01-01
10001   Ben     1982-04-02
10002   Curry   1985-08-12
10003   Davis   1978-07-12
10004   Ellis   1979-09-02
10005   Faried  1984-02-05
10007   Hamilton        1988-07-07
10008   Johnson 1986-06-07
10009   Jackson 1989-08-17
10010   James   1984-12-30
10011   Gay     1987-02-03
10012   Kaman   1981-04-04
10006   Wade    1982-03-04

 

插入刪除示例:
#include 
#include 
#include 
int main(int argc, const char *argv[])
{
    MYSQL           mysql;
    MYSQL_RES       *res = NULL;
    MYSQL_ROW       row;
    char            *query_str = NULL;
    int             rc, i, fields;
    int             rows;
    if (NULL == mysql_init(&mysql)) {
        printf("mysql_init(): %s\n", mysql_error(&mysql));
        return -1;
    }
    if (NULL == mysql_real_connect(&mysql,
                "localhost",
                "root",
                "shallnet",
                "db_users",
                0,
                NULL,
                0)) {
        printf("mysql_real_connect(): %s\n", mysql_error(&mysql));
        return -1;
    }
    printf("1. Connected MySQL successful! \n");
//執行插入請求
    query_str = "insert into tb_users values (12345, 'justtest', '2015-5-5')";
    rc = mysql_real_query(&mysql, query_str, strlen(query_str));
    if (0 != rc) {
        printf("mysql_real_query(): %s\n", mysql_error(&mysql));
        return -1;
    }
//執行刪除請求
    query_str = "delete from tb_users where userid=10006";
    rc = mysql_real_query(&mysql, query_str, strlen(query_str));
    if (0 != rc) {
        printf("mysql_real_query(): %s\n", mysql_error(&mysql));
        return -1;
    }
//然後查詢插入刪除之後的數據
    query_str = "select * from tb_users";
    rc = mysql_real_query(&mysql, query_str, strlen(query_str));
    if (0 != rc) {
        printf("mysql_real_query(): %s\n", mysql_error(&mysql));
        return -1;
    }
    res = mysql_store_result(&mysql);
    if (NULL == res) {
         printf("mysql_restore_result(): %s\n", mysql_error(&mysql));
         return -1;
    }
    rows = mysql_num_rows(res);
    printf("The total rows is: %d\n", rows);
    fields = mysql_num_fields(res);
    printf("The total fields is: %d\n", fields);
    while ((row = mysql_fetch_row(res))) {
        for (i = 0; i < fields; i++) {
            printf("%s\t", row[i]);
        }
        printf("\n");
    }
    mysql_free_result(res);
    mysql_close(&mysql);
    return 0;
}

編譯鏈接執行結果如下:

 

# make 
cc -Wall -Werror -O2 -I/usr/include/mysql/   -c -o main.o main.c
Linking target_bin...
# ./target_bin
1. Connected MySQL successful!
The total rows is: 13
The total fields is: 3
10000   Allen   1981-01-01
10001   Ben     1982-04-02
10002   Curry   1985-08-12
10003   Davis   1978-07-12
10004   Ellis   1979-09-02
10005   Faried  1984-02-05
10007   Hamilton        1988-07-07
10008   Johnson 1986-06-07
10009   Jackson 1989-08-17
10010   James   1984-12-30
10011   Gay     1987-02-03
10012   Kaman   1981-04-04
12345   justtest        2015-05-05

 

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved