2019獨(dú)角獸企業(yè)重金招聘Python工程師標(biāo)準(zhǔn)>>>

mysql_affected_rows()

返回上次UPDATE、DELETE或INSERT查詢更改／刪除／插入的行數(shù)。

mysql_autocommit()

切換?autocommit模式，ON/OFF

mysql_change_user()

更改打開連接上的用戶和數(shù)據(jù)庫。

mysql_charset_name()

返回用于連接的默認(rèn)字符集的名稱。

mysql_close()

關(guān)閉服務(wù)器連接。

mysql_commit()

提交事務(wù)。

mysql_connect()

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

mysql_create_db()

創(chuàng)建數(shù)據(jù)庫。該函數(shù)已不再被重視，使用SQL語句CREATE DATABASE取而代之。

mysql_data_seek()

在查詢結(jié)果集中查找屬性行編號(hào)。

mysql_debug()

用給定的字符串執(zhí)行DBUG_PUSH。

mysql_drop_db()

撤銷數(shù)據(jù)庫。該函數(shù)已不再被重視，使用SQL語句DROP DATABASE取而代之。

mysql_dump_debug_info()

讓服務(wù)器將調(diào)試信息寫入日志。

mysql_eof()

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

mysql_errno()

返回上次調(diào)用的MySQL函數(shù)的錯(cuò)誤編號(hào)。

mysql_error()

返回上次調(diào)用的MySQL函數(shù)的錯(cuò)誤消息。

mysql_escape_string()

為了用在SQL語句中，對(duì)特殊字符進(jìn)行轉(zhuǎn)義處理。

mysql_fetch_field()

返回下一個(gè)表字段的類型。

mysql_fetch_field_direct()

給定字段編號(hào)，返回表字段的類型。

mysql_fetch_fields()

返回所有字段結(jié)構(gòu)的數(shù)組。

mysql_fetch_lengths()

返回當(dāng)前行中所有列的長度。

mysql_fetch_row()

從結(jié)果集中獲取下一行

mysql_field_seek()

將列光標(biāo)置于指定的列。

mysql_field_count()

返回上次執(zhí)行語句的結(jié)果列的數(shù)目。

mysql_field_tell()

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

mysql_free_result()

釋放結(jié)果集使用的內(nèi)存。

mysql_get_client_info()

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

mysql_get_client_version()

以整數(shù)形式返回客戶端版本信息。

mysql_get_host_info()

返回描述連接的字符串。

mysql_get_server_version()

以整數(shù)形式返回服務(wù)器的版本號(hào)。

mysql_get_proto_info()

返回連接所使用的協(xié)議版本。

mysql_get_server_info()

返回服務(wù)器的版本號(hào)。

mysql_info()

返回關(guān)于最近所執(zhí)行查詢的信息。

mysql_init()

獲取或初始化MYSQL結(jié)構(gòu)。

mysql_insert_id()

返回上一個(gè)查詢?yōu)锳UTO_INCREMENT列生成的ID。

mysql_kill()

殺死給定的線程。

mysql_library_end()

最終確定MySQL C API庫。

mysql_library_init()

初始化MySQL C API庫。

mysql_list_dbs()

返回與簡單正則表達(dá)式匹配的數(shù)據(jù)庫名稱。

mysql_list_fields()

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

mysql_list_processes()

返回當(dāng)前服務(wù)器線程的列表。

mysql_list_tables()

返回與簡單正則表達(dá)式匹配的表名。

mysql_more_results()

檢查是否還存在其他結(jié)果。

mysql_next_result()

在多語句執(zhí)行過程中返回/初始化下一個(gè)結(jié)果。

mysql_num_fields()

返回結(jié)果集中的列數(shù)。

mysql_num_rows()

返回結(jié)果集中的行數(shù)。

mysql_options()

為mysql_connect()設(shè)置連接選項(xiàng)。

mysql_ping()

檢查與服務(wù)器的連接是否工作，如有必要重新連接。

mysql_query()

執(zhí)行指定為“以Null終結(jié)的字符串”的SQL查詢。

mysql_real_connect()

連接到MySQL服務(wù)器。

mysql_real_escape_string()

考慮到連接的當(dāng)前字符集，為了在SQL語句中使用，對(duì)字符串中的特殊字符進(jìn)行轉(zhuǎn)義處理。

mysql_real_query()

執(zhí)行指定為計(jì)數(shù)字符串的SQL查詢。

mysql_refresh()

刷新或復(fù)位表和高速緩沖。

mysql_reload()

通知服務(wù)器再次加載授權(quán)表。

mysql_rollback()

回滾事務(wù)。

mysql_row_seek()

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

mysql_row_tell()

返回行光標(biāo)位置。

mysql_select_db()

選擇數(shù)據(jù)庫。

mysql_server_end()

最終確定嵌入式服務(wù)器庫。

mysql_server_init()

初始化嵌入式服務(wù)器庫。

mysql_set_server_option()

為連接設(shè)置選項(xiàng)（如多語句）。

mysql_sqlstate()

返回關(guān)于上一個(gè)錯(cuò)誤的SQLSTATE錯(cuò)誤代碼。

mysql_shutdown()

關(guān)閉數(shù)據(jù)庫服務(wù)器。

mysql_stat()

以字符串形式返回服務(wù)器狀態(tài)。

mysql_store_result()

檢索完整的結(jié)果集至客戶端。

mysql_thread_id()

返回當(dāng)前線程ID。

mysql_thread_safe()

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

mysql_use_result()

初始化逐行的結(jié)果集檢索。

mysql_warning_count()

返回上一個(gè)SQL語句的告警數(shù)。

與MySQL交互時(shí)，應(yīng)用程序應(yīng)使用該一般性原則：

1.????通過調(diào)用mysql_library_init()，初始化MySQL庫。庫可以是mysqlclient?C客戶端庫，或mysqld嵌入式服務(wù)器庫，具體情況取決于應(yīng)用程序是否與“-libmysqlclient”或“-libmysqld”標(biāo)志鏈接。

2.????通過調(diào)用mysql_init()初始化連接處理程序，并通過調(diào)用mysql_real_connect()連接到服務(wù)器。

3.????發(fā)出SQL語句并處理其結(jié)果。（在下面的討論中，詳細(xì)介紹了使用它的方法）。

4.????通過調(diào)用mysql_close()，關(guān)閉與MySQL服務(wù)器的連接。

5.????通過調(diào)用mysql_library_end()，結(jié)束MySQL庫的使用。

調(diào)用mysql_library_init()和mysql_library_end()的目的在于，為MySQL庫提供恰當(dāng)?shù)某跏蓟徒Y(jié)束處理。對(duì)于與客戶端庫鏈接的應(yīng)用程序，它們提供了改進(jìn)的內(nèi)存管理功能。如果不調(diào)用mysql_library_end()，內(nèi)存塊仍將保持分配狀態(tài)（這不會(huì)增加應(yīng)用程序使用的內(nèi)存量，但某些內(nèi)存泄漏檢測器將抗議它）。對(duì)于與嵌入式服務(wù)器鏈接的應(yīng)用程序，這些調(diào)用會(huì)啟動(dòng)并停止服務(wù)器。

mysql_library_init()和mysql_library_end()實(shí)際上是#define符號(hào)，這類符號(hào)使得它們等效于mysql_server_init()和mysql_server_end()，但其名稱更清楚地指明，無論應(yīng)用程序使用的是mysqlclient或mysqld庫，啟動(dòng)或結(jié)束MySQL庫時(shí)，應(yīng)調(diào)用它們。對(duì)于早期的MySQL版本，可調(diào)用mysql_server_init()和mysql_server_end()取而代之。

如果愿意，可省略對(duì)mysql_library_init()的調(diào)用，這是因?yàn)?#xff0c;必要時(shí)，mysql_init()會(huì)自動(dòng)調(diào)用它。

要想連接到服務(wù)器，可調(diào)用mysql_init()來初始化連接處理程序，然后用該處理程序（以及其他信息，如主機(jī)名、用戶名和密碼）調(diào)用mysql_real_connect()。建立連接后，在低于5.0.3版的API中，mysql_real_connect()會(huì)將再連接標(biāo)志（MYSQL結(jié)構(gòu)的一部分）設(shè)置為1，或在較新的版本中，將其設(shè)置為0。對(duì)于該標(biāo)志，值“1”指明，如果因連接丟失而無法執(zhí)行語句，放棄之前，會(huì)嘗試再次連接到服務(wù)器。從MySQL 5.0.13開始，可以在mysql_options()上使用MYSQL_OPT_RECONNECT選項(xiàng)，以控制再連接行為。完成連接后，調(diào)用mysql_close()中止它。

當(dāng)連接處于活動(dòng)狀態(tài)時(shí)，客戶端或許會(huì)使用mysql_query()或mysql_real_query()向服務(wù)器發(fā)出SQL查詢。兩者的差別在于，mysql_query()預(yù)期的查詢?yōu)橹付ǖ摹⒂?span style="vertical-align:baseline;">Null終結(jié)的字符串，而mysql_real_query()預(yù)期的是計(jì)數(shù)字符串。如果字符串包含二進(jìn)制數(shù)據(jù)（其中可能包含Null字節(jié)），就必須使用mysql_real_query()。

對(duì)于每個(gè)非SELECT查詢（例如INSERT、UPDATE、DELETE），通過調(diào)用mysql_affected_rows()，可發(fā)現(xiàn)有多少行已被改變（影響）。

對(duì)于SELECT查詢，能夠檢索作為結(jié)果集的行。注意，某些語句因其返回行，類似與SELECT。包括SHOW、DESCRIBE和EXPLAIN。應(yīng)按照對(duì)待SELECT語句的方式處理它們。

客戶端處理結(jié)果集的方式有兩種。一種方式是，通過調(diào)用mysql_store_result()，一次性地檢索整個(gè)結(jié)果集。該函數(shù)能從服務(wù)器獲得查詢返回的所有行，并將它們保存在客戶端。第二種方式是針對(duì)客戶端的，通過調(diào)用mysql_use_result()，對(duì)“按行”結(jié)果集檢索進(jìn)行初始化處理。該函數(shù)能初始化檢索結(jié)果，但不能從服務(wù)器獲得任何實(shí)際行。

在這兩種情況下，均能通過調(diào)用mysql_fetch_row()訪問行。通過mysql_store_result()，mysql_fetch_row()能夠訪問以前從服務(wù)器獲得的行。通過mysql_use_result()，mysql_fetch_row()能夠?qū)嶋H地檢索來自服務(wù)器的行。通過調(diào)用mysql_fetch_lengths()，能獲得關(guān)于各行中數(shù)據(jù)大小的信息。

完成結(jié)果集操作后，請(qǐng)調(diào)用mysql_free_result()釋放結(jié)果集使用的內(nèi)存。

這兩種檢索機(jī)制是互補(bǔ)的。客戶端程序應(yīng)選擇最能滿足其要求的方法。實(shí)際上，客戶端最常使用的是mysql_store_result()。

mysql_store_result()的1個(gè)優(yōu)點(diǎn)在于，由于將行全部提取到了客戶端上，你不僅能連續(xù)訪問行，還能使用mysql_data_seek()或mysql_row_seek()在結(jié)果集中向前或向后移動(dòng)，以更改結(jié)果集內(nèi)當(dāng)前行的位置。通過調(diào)用mysql_num_rows()，還能發(fā)現(xiàn)有多少行。另一方面，對(duì)于大的結(jié)果集，mysql_store_result()所需的內(nèi)存可能會(huì)很大，你很可能遇到內(nèi)存溢出狀況。

mysql_use_result()的1個(gè)優(yōu)點(diǎn)在于，客戶端所需的用于結(jié)果集的內(nèi)存較少，原因在于，一次它僅維護(hù)一行（由于分配開銷較低，mysql_use_result()能更快）。它的缺點(diǎn)在于，你必須快速處理每一行以避免妨礙服務(wù)器，你不能隨機(jī)訪問結(jié)果集中的行（只能連續(xù)訪問行），你不知道結(jié)果集中有多少行，直至全部檢索了它們?yōu)橹埂２粌H如此，即使在檢索過程中你判定已找到所尋找的信息，也必須檢索所有的行。

通過API，客戶端能夠恰當(dāng)?shù)貙?duì)查詢作出響應(yīng)（僅在必要時(shí)檢索行），而無需知道查詢是否是SELECT查詢。可以在每次mysql_query()或mysql_real_query()后，通過調(diào)用mysql_store_result()完成該操作。如果結(jié)果集調(diào)用成功，查詢?yōu)?span style="vertical-align:baseline;">SELECT，而且能夠讀取行。如果結(jié)果集調(diào)用失敗，可調(diào)用mysql_field_count()來判斷結(jié)果是否的確是所預(yù)期的。如果mysql_field_count()返回0，查詢不返回?cái)?shù)據(jù)（表明它是INSERT、UPDATE、DELETE等），而且不返回行。如果mysql_field_count()是非0值，查詢應(yīng)返回行，但沒有返回行。這表明查詢是失敗了的SELECT。關(guān)于如何實(shí)現(xiàn)該操作的示例，請(qǐng)參見關(guān)于mysql_field_count()的介紹。

無論是mysql_store_result()還是mysql_use_result()，均允許你獲取關(guān)于構(gòu)成結(jié)果集的字段的信息（字段數(shù)目，它們的名稱和類型等）。通過重復(fù)調(diào)用mysql_fetch_field()，可以按順序訪問行內(nèi)的字段信息，或者，通過調(diào)用mysql_fetch_field_direct()，能夠在行內(nèi)按字段編號(hào)訪問字段信息。通過調(diào)用mysql_field_seek()，可以改變當(dāng)前字段的光標(biāo)位置。對(duì)字段光標(biāo)的設(shè)置將影響后續(xù)的mysql_fetch_field()調(diào)用。此外，你也能通過調(diào)用mysql_fetch_fields()，一次性地獲得關(guān)于字段的所有信息。

為了檢測和通報(bào)錯(cuò)誤，MySQL提供了使用mysql_errno()和mysql_error()函數(shù)訪問錯(cuò)誤信息的機(jī)制。它們能返回關(guān)于最近調(diào)用的函數(shù)的錯(cuò)誤代碼或錯(cuò)誤消息，最近調(diào)用的函數(shù)可能成功也可能失敗，這樣，你就能判斷錯(cuò)誤是在何時(shí)出現(xiàn)的，以及錯(cuò)誤是什么。

摘自：MYSQL參考手冊(cè)

網(wǎng)址：http://dev.mysql.com/doc/refman/5.1/zh/apis.html

轉(zhuǎn)載于:https://my.oschina.net/jhdoctor/blog/101559

總結(jié)

以上是生活随笔為你收集整理的C API可使用的函数归纳的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。