5.3 C API 基本函数参考_MySQL 8.0 C API 开发者指南

MySQL 8.0 C API 开发者指南 / 第 5 章 C API 基本接口 / 5.3 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()`	为下一个执行的语句定义查询属性	8.0.23
`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()`调用的会话数据句柄	8.0.29
`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 的连接返回会话数据	8.0.29
`mysql_get_ssl_session_reused()`	session是否被重用	8.0.29
`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()`	平服务器
`mysql_query()`	执行语句
`mysql_real_connect()`	连接到 MySQL 服务器
`mysql_real_connect_dns_srv()`	使用 DNS SRV 记录连接到 MySQL 服务器	8.0.22
`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()`	结果集是否有元数据	8.0.13
`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()`	前一条语句的警告计数