C MYSQL 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终结的字符串,而mysql_real_query()预期的是计数字符串。如果字符串包 含二进制数据(其中可能包含Null字节),就必须使用mysql_real_query()。
对于每个非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()函数访问错误信息的机制。它们能返回关于最近调用的函数的错误代码或错误消息,最近调用的函数可能成功也可能失败,这样,你就能判断错误是在何时出现的,以及错误是什么。
相关推荐
提供了一个MySQL API接口,可以将MYSQL的函数封装成上层接口,以实现连接,断开,增删改的功能
这个是MySQL常用的C语言的API函数,对MySQL与C编程的人有用,是DOC格式的文档。
mysql c api 为iphone里连接数据库不可缺少的库
这是C语言开发mysql用的中文手册,里面基本涵盖了mysql的CApi解释说明,还有用例。对刚接触mysql的c开发者很有用
这是一个简单的MySql C API 的 C++ 包装,适合初学者。
25.2. MySQL C API 25.2.1. C API数据类型 25.2.2. C API函数概述 25.2.3. C API函数描述 25.2.4. C API预处理语句 25.2.5. C API预处理语句的数据类型 25.2.6. C API预处理语句函数概述 25.2.7. C API预处理语句...
#VC6通过API连接Mysql测试环境 #创建数据库 drop database if exists `test`; #如果有这个数据库,则移除它 create database test; #创建数据库 use test; #使用数据库 #创建表User,保存会员属性 drop table if ...
mysql—capi文档 使用C调用sql接口文档
MySQL数据库,C++,CAPI,C++链接MySQL数据库,通过C++对MySQL数据库进行增删改查,C++第三方库
初始版本发布,主要封装一些访问 MYSQL 的 C API,能便捷的访问 MYSQL 数据库; 2. 2010年 版本是原来版本的修正版本; 主要增加功能如下: 1. 支持多地址分布式部署数据库连接; 2. 支持数据库连接池; 3. 支持数据库...
在centos下进行的mysql相关的的C_API的操作说明和应用及源码例子 涉及方面: 1.centos下mysql数据库的安装 2.sql语句 3.非预处理API 4.预处理API 5.C-API的应用代码 6.Makefile 7.编译结果及遇到的错误分析
单兴华CTO-学习Mysql经典教程-第06章MySQL C API.pdf 单兴华CTO-学习Mysql经典教程-第07章Perl DBI API.pdf 单兴华CTO-学习Mysql经典教程-第08章PHP API.pdf 单兴华CTO-学习Mysql经典教程-第09章MySQL 管理介绍.pdf ...
mysql C API 官方的中文说明文档(包括 mysql_stmt 的) 附一个mysql官方全面的C API说明文档(英文) 可供新手学习参考
封装了mysql 的c开发api. libmysql的封装
一个简单易用的C++连接并使用MySQL的例子, 需要带上lib里的那个libMySQL.dll, 如果你要纯静态的话, 请使用 vs12/14里的那个lib, 然后注释掉 #pragma comment(lib, "lib/mysql.lib"), 不过只有release的版本就对了, ...
一个用mysql C API 实现的简单题库系统,VC6.0下编译,其它VC平台一样可用,具体参看代码。现在手上还有一个功能更加完善的,要用的联系本人,fnxjiabo@qq.com
MySQL是一个精巧的SQL数据库...MySQL有瑞典的T.c.X公司负责开发和维护,MySQL的用户手册很单纯,只有一个集中的<MySQL Reference Manual>,但其内容覆盖了MySQL的所有信息,因此该手册是了解和掌握MySQL的绝佳文献。
适合新手学习mysql API, 代码准确无误
使用MYSQL的C API进行数据库各种操作,代码中添加了详细注释,对于学习MYSQL极有帮助。