MySQL :: MySQL 8.4 C API 開發人員指南 :: 5.3 C API 基本函數參考

版本 8.4

MySQL 8.4 C API 開發人員指南 / C API 基本介面 / C API 基本函數參考

5.3 C API 基本函數參考

下表總結了 C API 基本介面中可用的函數。如需更多詳細資訊，請參閱第 5.4 節，「C API 基本函數描述」中的說明。

表 5.1 C API 基本介面函數

名稱	描述	已棄用
`mysql_affected_rows()`	最後一個 `UPDATE`、`DELETE` 或 `INSERT` 陳述式變更/刪除/插入的列數
`mysql_autocommit()`	設定自動提交模式
`mysql_bind_param()`	為下一個執行的陳述式定義查詢屬性
`mysql_change_user()`	變更開啟連線上的使用者和資料庫
`mysql_character_set_name()`	目前連線的預設字元集名稱
`mysql_close()`	關閉與伺服器的連線
`mysql_commit()`	提交交易
`mysql_connect()`	連線至 MySQL 伺服器	是
`mysql_create_db()`	建立資料庫	是
`mysql_data_seek()`	在查詢結果集中搜尋任意列號
`mysql_debug()`	使用給定字串執行 `DBUG_PUSH`
`mysql_drop_db()`	刪除資料庫	是
`mysql_dump_debug_info()`	使伺服器將除錯資訊寫入錯誤日誌
`mysql_eof()`	判斷是否已讀取結果集的最後一列	是
`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_count()`	最近陳述式的結果欄數
`mysql_field_seek()`	在結果集列中搜尋欄位
`mysql_field_tell()`	最後一次 `mysql_fetch_field()` 呼叫的欄位位置
`mysql_free_result()`	釋放結果集記憶體
`mysql_free_ssl_session_data()`	處置上次 `mysql_get_ssl_session_data()` 呼叫的會話資料控制代碼
`mysql_get_character_set_info()`	關於預設字元集的資訊
`mysql_get_client_info()`	用戶端版本（字串）
`mysql_get_client_version()`	用戶端版本（整數）
`mysql_get_host_info()`	關於連線的資訊
`mysql_get_option()`	`mysql_options()` 選項的值
`mysql_get_proto_info()`	連線使用的協定版本
`mysql_get_server_info()`	伺服器版本號碼（字串）
`mysql_get_server_version()`	伺服器版本號碼（整數）
`mysql_get_ssl_cipher()`	目前的 SSL 加密方式
`mysql_get_ssl_session_data()`	傳回啟用 SSL 連線的會話資料
`mysql_get_ssl_session_reused()`	是否重複使用會話
`mysql_hex_string()`	以十六進位格式編碼字串
`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_options4()`	在連線前設定選項
`mysql_ping()`	Ping 伺服器
`mysql_query()`	執行陳述式
`mysql_real_connect()`	連線至 MySQL 伺服器
`mysql_real_connect_dns_srv()`	使用 DNS SRV 記錄連線至 MySQL 伺服器
`mysql_real_escape_string()`	編碼陳述式字串中的特殊字元
`mysql_real_escape_string_quote()`	編碼陳述式字串中的特殊字元，同時考量引號上下文
`mysql_real_query()`	執行陳述式
`mysql_refresh()`	清除或重設表格和快取
`mysql_reload()`	重新載入授權表格	是
`mysql_reset_connection()`	重設連線以清除會話狀態
`mysql_reset_server_public_key()`	從用戶端程式庫清除快取的 RSA 公開金鑰
`mysql_result_metadata()`	結果集是否有中繼資料
`mysql_rollback()`	復原交易
`mysql_row_seek()`	在結果集中搜尋列偏移
`mysql_row_tell()`	結果集列中的目前位置
`mysql_select_db()`	選取資料庫
`mysql_server_end()`	完成 MySQL C API 程式庫
`mysql_server_init()`	初始化 MySQL C API 程式庫
`mysql_session_track_get_first()`	會話狀態變更資訊的第一部分
`mysql_session_track_get_next()`	會話狀態變更資訊的下一部分
`mysql_set_character_set()`	設定目前連線的預設字元集
`mysql_set_local_infile_default()`	將 `LOAD DATA LOCAL` 處理常式回呼設定為預設值
`mysql_set_local_infile_handler()`	安裝應用程式特定的 `LOAD DATA LOCAL` 處理常式回呼
`mysql_set_server_option()`	設定目前連線的選項
`mysql_shutdown()`	關閉 MySQL 伺服器
`mysql_sqlstate()`	最近調用的 MySQL 函數的 SQLSTATE 值
`mysql_ssl_set()`	準備建立與伺服器的 SSL 連線	是
`mysql_stat()`	伺服器狀態
`mysql_store_result()`	擷取和儲存整個結果集
`mysql_thread_id()`	目前的線程 ID
`mysql_use_result()`	啟動逐列結果集擷取
`mysql_warning_count()`	先前陳述式的警告計數