精华内容
下载资源
问答
  • 关于客户(销售员该如何找客户才好) 1、旧时指以租佃为生的人家。2、旧时指外地迁来的住户。(以上两条详见下文)。3、工厂企业或经纪人称...教你怎样寻找客户源(销售员该如何找客户才好) 刚入行的销售员,首先要

    关于客户(销售员该如何找客户才好)

    1、旧时指以租佃为生的人家。2、旧时指外地迁来的住户。(以上两条详见下文)。3、工厂企业或经纪人称来往的主顾;客商。4、在网络的通信方式中,指服务的请求方。5、在客户关系管理中,客户是对企业产品和服务有特定需求的群体,它是企业经营活动得以维持的根本保证。6、客户是服务请求方。

    教你怎样寻找客户源(销售员该如何找客户才好)

    刚入行的销售员,首先要面对客户在哪里的问题?就是干了多年的销售员遇到新的产品,特别是新出现的产品,有时连行业都分不清楚。比如:我做了十多年的销售,当开始做品牌的客户关系管理系统这个项目时,就拿不准是要去哪里找代理商渠道,后来通过向同行的学习,探讨慢慢的摸索出了方向。还有就是随着科技的发展,一些跨行业,综合性能的产品会越来越多,渠道方向就涉及到好多路径,同时还要考虑到哪方面的渠道更适合等方面因素,这就为销售员提出了新的问题。那么,我们在寻找客户的过程中应注意些什么呢?

    一、普遍寻找法

    这种方法也称逐户寻找法或者地毯式寻找法。其方法的要点是,在业务员特定的市场区域范围内,针对特定的群体,用上门、邮件或者电话、电子邮件等方式对该范围内的组织、家庭或者个人无遗漏地进行寻找与确认的方法。比如,将某市某个居民新村的所有家庭作为普遍寻找对象,将上海地区所有的宾馆、饭店作为地毯式寻找对象等。

    普遍寻找法有以下的优势:

    1、地毯式的铺开不会遗漏任何有价值的客户;

    2、寻找过程中接触面广、信息量大、各种意见和需求、客户反应都可能收集到,是分析市场的一种方法;

    3、让更多的人了解到自己的企业。

    当然其缺点也是很明显的:

    1、成本高、费时费力;

    2、容易导致客户的抵触情绪。

    因此,如果活动可能会对客户的工作、生活造成不良的干扰,一定要谨慎进行。

    普遍寻找法可以采用业务员亲自上门、邮件发送、电话、与其他促销活动结合进行的方式展开。

    二、广告寻找法

    这种方法的基本步骤是:(1)向目标顾客群发送广告;(2)吸引顾客上门展开业务活动或者接受反馈。例如,通过媒体发送某个减肥器具的广告,介绍其功能、购买方式、地点、代理和经销办法等,然后在目标区域展开活动。

    广告寻找法的优点是:

    1、传播信息速度快、覆盖面广、重复性好;

    2、相对普遍寻找法更加省时省力;

    其缺点是需要支付广告费用、针对性和及时反馈性不强。

    三、介绍寻找法

    这种方法是业务员通过他人的直接介绍或者提供的信息进行顾客寻找,可以通过业务员的熟人、朋友等社会关系,也可以通过企业的合作伙伴、客户等由他们进行介绍,主要方式有电话介绍、口头介绍、信函介绍、名片介绍、口碑效应等。

    利用这个方法的关键是业务员必须注意培养和积累各种关系,为现有客户提供的满意的服务和可能的帮助,并且要虚心地请求他人的帮助。口碑好、业务印象好、乐于助人、与客户关系好、被人信任的业务员一般都能取得有效的突破。

    介绍寻找客户法由于有他人的介绍或者成功案例和依据,成功的可能性非常大,同时也可以降低销售费用,减小成交障碍,因此业务员要重视和珍惜。

    四、资料查阅寻找法

    我们一直认为,业务员要有强的信息处理能力,通过资料查阅寻找客户既能保证一定的可靠性,也减小工作量、提高工作效率,同时也可以最大限度减少业务工作的盲目性和客户的抵触情绪,更重要的是,可以展开先期的客户研究,了解客户的特点、状况,提出适当的客户活动针对性策略等。

    需要注意的是资料的时效性和可靠性,此外,注意对资料(行业的或者客户的)日积月累往往更能有效地展开工作。

    业务员经常利用的资料有:有关政府部门提供的资料、有关行业和协会的资料、国家和地区的统计资料、企业黄页、工商企业目录和产品目录、电视、报纸、杂志、互联网等大众媒体、客户发布的消息、产品介绍、企业内刊等等,而互联网信息虽广而多,但是还是要到一些可信专业的网站上进行相关的资料搜集,比如有关政府部门的资料就是去一些当地的政府部门网站,有关行业和协会的资料就去自己行业协会的网站上去,其他的资料以此类推,找最权威的网站,相关性高,找到的资料才会准确。

    一些有经验的业务员,在出发和客户接触之前,往往会通过大量的资料研究对客户做出非常充分的了解和判断。

    五、委托助手寻找法

    这种方法在国外用得比较多,一般是业务员在自己的业务地区或者客户群中,通过有偿的方式委托特定的人为自己收集信息,了解有关客户和市场、地区的情报资料等等,这优点象香港**使用“线民”,在国内的企业,笔者也见过,就是业务员在企业的中间商中间,委托相关人员定期或者不定期提供一些关于产品、销售的信息。

    另一种方式是,老业务员有时可以委托新业务员从事这方面的工作,对新业务员也是一个有效的锻炼。

    六、客户资料整理法

    这种方法本质上属于“资料查阅寻找法”,但是,也有其特殊性,我们强调客户资料管理,因为其重要性十分突出,现有的客户、与企业联系过的单位、企业举办活动(如公关、市场调查)的参与者等等,他们的信息资料都应该得到良好的处理和保存,这些资料积累到一定的程度,就是一笔财富,在市场营销精耕细作的今天,这尤为重要,这同时也要得力于CRM客户关系管理系统,处理、管理繁杂的客户资料为企业,为个人带来了多大的帮助。现在难以想象如果一个企业没有用到CRM客户关系管理系统或者是OA会变得多么糟糕,如果面对你繁多的客户需要管理还没用到类似工具的话,那你是out了。

    举个最简单的例子,某个家庭,第一代洗衣机购买的是“小天鹅双桶洗衣机”、第二代洗衣机是“小天鹅全自动洗衣机”、第三代洗衣机是“小天鹅滚筒式洗衣机”,你如果要做到真正让客户的三代洗衣机都用“小天鹅”,客户的资料和客户的精细服务就是必不可少的。开个玩笑的话,小天鹅可以提出一个营销内部口号:“让小天鹅在顾客家里代代相传”。

    七、交易会寻找法

    国际国内每年都有不少交易会,如广交会、高交会、中小企业博览会等等,这是一个绝好的商机,要充分利用,交易会不仅实现交易,更重要的是寻找客户、联络感情、沟通了解。奥联的一个客户的老总,参加了今年的广交会回来,向全体员工宣布一个惊人的好消息:“我有足够的信心向大家保证:今年我们的销售收入可以增加2个亿!”,其成效明显主要原因之一是因为其产品的特殊性,但是更重要的是企业已经全面学会和掌握了这个有效的途径。

    八、咨询寻找法

    一些组织,特别是行业组织、技术服务组织、咨询单位等,他们手中往往集中了大量的客户资料和资源以及相关行业和市场信息,通过咨询的方式寻找客户不仅是一个有效的途径,有时还能够获得这些组织的服务、帮助和支持,比如在客户联系、介绍、市场进入方案建议等方面。我们就曾经为一个国外企业进入中国市场提出合作建议方案,寻找合作者甚至参与项目论证等方面提供过一揽子服务。

    九、企业各类活动寻找法

    企业通过公共关系活动、市场调研活动、促销活动、技术支持和售后服务活动等,一般都会直接接触客户,这个过程中对客户的观察、了解、深入的沟通都非常有力,也是一个寻找客户的好方法。

    有效地寻找客户方法远远不止这些,应该说,是一个随时随地的过程。一般信息处理过程是:“所有目标对象-接触和信息处理-初选―精选―重点潜在客户―客户活动计划”。

    展开全文
  • MySQL客户工具和API

    千次阅读 2011-09-27 16:41:36
    20 MySQL客户工具和API 20.1 MySQL C API C API代码是随MySQL分发的,它被包含在mysqlclient库且允许C程序存取一个数据库。 在 MySQL代码分发中的很多客户...如果你正在寻找演示怎样使用C API的例子,看一下这些客
     
    

    20 MySQL客户工具和API

    20.1 MySQL C API

    C API代码是随MySQL分发的,它被包含在mysqlclient库且允许C程序存取一个数据库。

    在 MySQL源代码分发中的很多客户是用C编写的。如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。

    大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服务器通信。这意味着,例如,你能利用很多被其他客户程序使用的同一环境变量,因为他们从库中引用。对这些变量的一张表,见12.1 不同的MySQL程序的概述

    客户有一个最大通讯缓冲区大小。初始分配的缓冲区大小(16K字节) 自动地增加到最大尺寸(缺省的最大值是24M)。因为缓冲区大小只是按保证需求而被增加,简单地增加缺省的最大限制并不造成更多被消耗。该尺寸检查主要是一个对错误的查询和通讯包的检查。

    通讯缓冲区必须足够大以便一个单独的SQL语句(对客户-服务器传输)和一行返回的数据(对服务器-客户传输)。每个线程的通讯缓冲区被动态扩大到最大限制来处理任何查询或行。例如,如果你包含大到16M数据的BLOB值,你必须有一个至少16M通讯缓冲区限制(在服务器和客户两端)。客户的缺省最大值是24M,但是在服务器端的缺省最大值是1M。你可以在服务器启动时通过改变max_allowed_packet参数的值来改变它。见10.2.3 调节服务器参数

    MySQL服务器在每个查询后缩小每个通讯缓冲区到net_buffer_length个字节。对客户,与一个连接相关的缓冲区的大小没被减少,直到连接被关闭,在此时客户内存被回收。

    如果你用线程的编程,你应该用--with-thread-safe-client编译MySQL C API,这将使C API线程对每个连接更安全。你可以让2个线程共享相同的连接,只要如果你做下列事情:

    两个线程不能同时在同一个连接上发送查询到MySQL。特别是你必须保证在一个mysql_query()mysql_store_result()之间没有其他线程正在使用同一个连接。
    许多线程能存取用mysql_store_result()检索出来的不同结果集合。
    如果你使用mysql_use_result,你必须保证没有其他线程在同一个连接上正在询问任何东西,直到结果集合被关闭。

    20.2 C API数据类型

    MYSQL
    这个结构表示对一个数据库连接的句柄,它被用于几乎所有的MySQL函数。
    MYSQL_RES
    这个结构代表返回行的一个查询的(SELECT, SHOW, DESCRIBE, EXPLAIN)的结果。从查询返回的信息在本章下文称为结果集合
    MYSQL_ROW
    这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。(如果字段值可能包含二进制数据,你不能将这些视为空终止串,因为这样的值可以在内部包含空字节) 行通过调用mysql_fetch_row()获得。
    MYSQL_FIELD
    这个结构包含字段信息,例如字段名、类型和大小。其成员在下面更详细地描述。你可以通过重复调用mysql_fetch_field()对每一列获得MYSQL_FIELD结构。字段值不是这个结构的部分;他们被包含在一个MYSQL_ROW结构中。
    MYSQL_FIELD_OFFSET
    这是一个相对一个MySQL字段表的偏移量的类型安全的表示。(由mysql_field_seek()使用。) 偏移量是在一行以内的字段编号,从0开始。
    my_ulonglong
    该类型用于行编号和mysql_affected_rows()mysql_num_rows()mysql_insert_id()。这种类型提供01.84e19的一个范围。在一些系统上,试图打印类型my_ulonglong的值将不工作。为了打印出这样的值,将它变换到unsigned long并且使用一个%lu打印格式。例如:
    printf (Number of rows: %lu\n", (unsigned long) mysql_num_rows(result));
    

    MYSQL_FIELD结构包含列在下面的成员:

    char * name
    字段名,是一个空结尾的字符串。
    char * table
    包含该字段的表的名字,如果它不是可计算的字段。对可计算的字段,table值是一个空字符串。
    char * def
    这字段的缺省值,是一个空结尾的字符串。只要你使用,只有你使用mysql_list_fields()才可设置它。
    enum enum_field_types type
    字段类型。type值可以是下列之一:
    类型值 类型含义
    FIELD_TYPE_TINY TINYINT字段
    FIELD_TYPE_SHORT SMALLINT字段
    FIELD_TYPE_LONG INTEGER字段
    FIELD_TYPE_INT24 MEDIUMINT字段
    FIELD_TYPE_LONGLONG BIGINT字段
    FIELD_TYPE_DECIMAL DECIMALNUMERIC字段
    FIELD_TYPE_FLOAT FLOAT字段
    FIELD_TYPE_DOUBLE DOUBLEREAL字段
    FIELD_TYPE_TIMESTAMP TIMESTAMP字段
    FIELD_TYPE_DATE DATE字段
    FIELD_TYPE_TIME TIME字段
    FIELD_TYPE_DATETIME DATETIME字段
    FIELD_TYPE_YEAR YEAR字段
    FIELD_TYPE_STRING 字符串(CHARVARCHAR)字段
    FIELD_TYPE_BLOB BLOBTEXT字段(使用max_length决定最大长度)
    FIELD_TYPE_SET SET字段
    FIELD_TYPE_ENUM ENUM字段
    FIELD_TYPE_NULL NULL- 类型字段
    FIELD_TYPE_CHAR 不推荐;使用FIELD_TYPE_TINY代替

    你可以使用IS_NUM()宏来测试字段是否有一种数字类型。将type值传给IS_NUM()并且如果字段是数字的,它将计算为TRUE:

    if (IS_NUM(field->type))
        printf("Field is numeric\n");
    
    unsigned int length
    字段宽度,在表定义中指定。
    unsigned int max_length
    对结果集合的字段的最大宽度(对实际在结果集合中的行的最长字段值的长度)。如果你使用mysql_store_result()mysql_list_fields(),这包含字段最大长度。如果你使用mysql_use_result(),这个变量的值是零。
    unsigned int flags
    字段的不同位标志。flags值可以是零个或多个下列位设置:
    标志值 标志含义
    NOT_NULL_FLAG 字段不能是NULL
    PRI_KEY_FLAG 字段是一个主键的一部分
    UNIQUE_KEY_FLAG 字段是一个唯一键的一部分
    MULTIPLE_KEY_FLAG 字段是一个非唯一键的一部分。
    UNSIGNED_FLAG 字段有UNSIGNED属性
    ZEROFILL_FLAG 字段有ZEROFILL属性
    BINARY_FLAG 字段有BINARY属性
    AUTO_INCREMENT_FLAG 字段有AUTO_INCREMENT属性
    ENUM_FLAG 字段是一个ENUM(不推荐)
    BLOB_FLAG 字段是一个BLOBTEXT(不推荐)
    TIMESTAMP_FLAG 字段是一个TIMESTAMP(不推荐)

    BLOB_FLAGENUM_FLAGTIMESTAMP_FLAG标志的使用是不推荐的,因为他们指出字段的类型而非它的类型属性。对FIELD_TYPE_BLOBFIELD_TYPE_ENUMFIELD_TYPE_TIMESTAMP,最好是测试field->type。下面例子演示了一个典型的flags值用法:

    if (field->flags & NOT_NULL_FLAG)
        printf("Field can't be null\n");
    

    你可以使用下列方便的宏决来确定flags值的布尔状态:

    IS_NOT_NULL(flags) 真,如果该字段被定义为NOT NULL
    IS_PRI_KEY(flags) 真,如果该字段是一个主键
    IS_BLOB(flags) 真,如果该字段是一个BLOBTEXT(不推荐;相反测试field->type
    unsigned int decimals
    对数字字段的小数位数。

    20.3 C API函数概述

    在 C API 中可用的函数列在下面,并且在下一节更详细地描述。见20.4 C API函数描述

    mysql_affected_rows() 返回被最新的UPDATE, DELETEINSERT查询影响的行数。
    mysql_close() 关闭一个服务器连接。
    mysql_connect() 连接一个MySQL服务器。该函数不推荐;使用mysql_real_connect()代替。
    mysql_change_user() 改变在一个打开的连接上的用户和数据库。
    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_host_info() 返回一个描述连接的字符串。
    mysql_get_proto_info() 返回连接使用的协议版本。
    mysql_get_server_info() 返回服务器版本号。
    mysql_info() 返回关于最近执行得查询的信息。
    mysql_init() 获得或初始化一个MYSQL结构。
    mysql_insert_id() 返回有前一个查询为一个AUTO_INCREMENT列生成的ID。
    mysql_kill() 杀死一个给定的线程。
    mysql_list_dbs() 返回匹配一个简单的正则表达式的数据库名。
    mysql_list_fields() 返回匹配一个简单的正则表达式的列名。
    mysql_list_processes() 返回当前服务器线程的一张表。
    mysql_list_tables() 返回匹配一个简单的正则表达式的表名。
    mysql_num_fields() 返回一个结果集合重的列的数量。
    mysql_num_rows() 返回一个结果集合中的行的数量。
    mysql_options() 设置对mysql_connect()的连接选项。
    mysql_ping() 检查对服务器的连接是否正在工作,必要时重新连接。
    mysql_query() 执行指定为一个空结尾的字符串的SQL查询。
    mysql_real_connect() 连接一个MySQL服务器。
    mysql_real_query() 执行指定为带计数的字符串的SQL查询。
    mysql_reload() 告诉服务器重装授权表。
    mysql_row_seek() 搜索在结果集合中的行,使用从mysql_row_tell()返回的值。
    mysql_row_tell() 返回行光标位置。
    mysql_select_db() 连接一个数据库。
    mysql_shutdown() 关掉数据库服务器。
    mysql_stat() 返回作为字符串的服务器状态。
    mysql_store_result() 检索一个完整的结果集合给客户。
    mysql_thread_id() 返回当前线程的ID。
    mysql_use_result() 初始化一个一行一行地结果集合的检索。

    为了连接服务器,调用mysql_init()以初始化一个连接处理器,然后用该处理器调用mysql_real_connect()(还有其他信息例如主机名、用户名和口令)。当你用该连接完成工作后,调用mysql_close()终止它。

    当一个连接活跃时,客户可以用mysql_query()mysql_real_query()将SQL查询发送到服务器。两者的差别是mysql_query()期望查询作为一个空结尾的字符串来指定而mysql_real_query()期望一个计数的字符串。如果字符串包含二进制数据(它可以包括空字节),你必须使用mysql_real_query()

    对与每个非--SELECT查询(例如,INSERTUPDATEDELETE等),你可以调用mysql_affected_rows()知道有多少行受到影响(改变)。

    对于SELECT查询,你作为一个结果集合来检索选择的行。(注意一些语句是类SELECT的,他们返回行。这些包括SHOWDESCRIBEEXPLAIN。他们应该象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()的一个优点是既然行均被客户取到,你不仅能顺序存取行,你也能mysql_data_seek()mysql_row_seek()在结果集合中前后移动以改变在结果集合中的当前行位置。你也能通过调用mysql_num_rows()知道有多少行。另一方面,mysql_store_result()的内存需求对较大结果集合可能很高,并且你最可能遇到out-of-memory情况。

    mysql_use_result()的一个优点是客户为结果集合需要较少的内存,因为它一次只是维持一行(并且因为有较少的分配开销,mysql_use_result()能更快些)。缺点是你必须尽快处理每一行以避免困住服务器,你不必再结果集合中随意存取行(你只能顺序存取行),而且你不知道在结果集合中有多少行,直到你检索全部结果。还有,你必须检索出所有行,即使你在检索中途确定你已找到了想寻找的信息。

    API使得客户正确应答查询成为可能(仅检索必要的行),不用知道查询是否是一个SELECT。你可以通过在mysql_query()(或mysql_real_query())之后调用mysql_store_result()做到。如果结果集合调用成功并且查询是一个SELECT,你能读取行。如果结果集合调用,调用mysql_field_count()确定结果是否是实际期望的。如果mysql_field_count()返回0,查询没有返回数据(表明它是一个INSERTUPDATE、DELETE等),所以不期望返回行。如果mysql_field_count()是非零,查询应该有返回行,但是没有。这表明查询是一个失败的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()函数提供错误信息的存取。他们返回最近调用的可能成功或失败的函数的错误代码或错误消息,允许你确定何时发生一个错误和什么错误。

    20.4 C API函数描述

    在下面的描述中,一个NULL参数或返回值含义是在C编程语言环境的NULL,不是一个MySQL NULL值。

    返回一个值的函数一般返回一个指针或一个整数。除非另外指定,返回一个指针的函数返回一个非 NULL值表明成功,或一个NULL值表明一个错误,而返回一个整数的函数返回零表示成功,或非零表示一个错误。注意,“非零”只有这个含义。除非函数描述另外说明,不要测试一个零以外的其他值:

    if (result)                   /* 正确 */
        ... error ...
    
    if (result < 0)               /* 不正确 */
        ... error ...
    
    if (result == -1)             /* 不正确 */
        ... error ...
    
    

    当函数返回一个错误时,函数描述的错误小节列出错误可能的类型。你可以调用mysql_errno()找出发生了这些重的哪一个。错误的字符串表示可以调用mysql_error()获得。

    20.4.1 mysql_affected_rows()

    my_ulonglong mysql_affected_rows(MYSQL *mysql)

    20.4.1.1 说明

    返回受到最后一个UPDATEDELETEINSERT查询影响(变化)的行数。可以在针对UPDATEDELETEINSERT语句的mysql_query()之后立即调用。对于SELECT语句,mysql_affected_rows()的功能于mysql_num_rows()相同。

    mysql_affected_rows()目前以一个宏(macro)来实现。

    20.4.1.2 返回值

    大于零的一个整数表示受到影响或检索出来的行数。零表示没有匹配查序中WHERE子句的记录或目前还没有查询被执行。-1表示查询返回一个错误,或对于一个SELECT查询,mysql_affected_rows()在调用mysql_store_result()之前被调用。

    20.4.1.3 错误

    没有。

    20.4.1.4 范例

    mysql_query(&mysql,"UPDATE products SET cost=cost*1.25 WHERE group=10");
    printf("%d products updated",mysql_affected_rows(&mysql));
     

    20.4.2 mysql_close()

    void mysql_close(MYSQL *mysql)

    20.4.2.1 说明

    关闭一个以前打开了的连接。如果句柄由mysql_init()mysql_connect()自动分配,mysql_close()也释放被mysql指向的连接句柄。

    20.4.2.2 返回值

    没有。

    20.4.2.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.3 mysql_connect()

    MYSQL *mysql_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd)

    20.4.3.1 说明

    该函数不推荐使用,而更好使用mysql_real_connect()

    mysql_connect()试图建立一个对运行在host的一个MySQL数据库引擎的连接。mysql_connect()必须在你能执行其他API函数之前成功地完成,除了mysql_get_client_info()

    参数的含义与mysql_connect()相应的参数相同,不同的是连接参数可以是NULL。在这种情况下,C API 自动为连接结构分配内存,并且当你调用mysql_close(),释放它。这种方法的缺点是如果连接失败,你不能检索出一条错误消息。(为了从mysql_errno()mysql_error()得到错误信息,你必须提供一个有效的MYSQL指针。)

    20.4.3.2 返回值

    mysql_real_connect()

    20.4.3.3 错误

    mysql_real_connect()

    20.4.4mysql_change_user()

    my_bool mysql_change_user(MYSQL *mysql, const char *user, const char *password, const char *db)

    20.4.4.1 说明

    改变用户并且使得由db指定数据库成为由mysql指定的连接上的缺省(当前)数据库。在随后的查询中,这个数据库是不包括一个明确的数据库指定符的表引用的缺省值。

    这个函数功能在MySQL 3.23.3中引入。

    除非连接的用户能被认证或如果他没有权限使用数据库,mysql_change_user()失败。在这种情况下,用户和数据库都没被改变。

    如果你不想有一个缺省数据库,db参数可以被设置为NULL

    20.4.4.2 返回值

    成功,零。如果发生一个错误发生,非零。

    20.4.4.3 错误

    与你能从mysql_real_connect()得到的相同。

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。
    ER_UNKNOWN_COM_ERROR
    MySQL服务器未实现这个命令(可能是一个老的服务器)
    ER_ACCESS_DENIED_ERROR
    用户或口令错误。
    ER_BAD_DB_ERROR
    数据库不存在。
    ER_DBACCESS_DENIED_ERROR
    用户没有数据库的存取权利。
    ER_WRONG_DB_NAME
    数据库名字太长。

    20.4.4.4 范例

    if (mysql_change_user(&mysql, "user", "password", "new_database"))
    {
       fprintf(stderr, "Failed to change user.  Error: %s\n",
               mysql_error(&mysql));
    }
     

    20.4.5 mysql_create_db()

    int mysql_create_db(MYSQL *mysql, const char *db)

    20.4.5.1 说明

    创建由db参数命名的数据库。

    这个函数不推荐,而最好使用mysql_query()发出一条SQL CREATE DATABASE语句。

    20.4.5.2 返回值

    如果数据库成功地被创造,零。如果发生一个错误,非零。

    20.4.5.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。 

    20.4.5.4 范例

    if(mysql_create_db(&mysql, "my_database"))
    {
       fprintf(stderr, "Failed to create new database.  Error: %s\n",
               mysql_error(&mysql));
    }
     

    20.4.6 mysql_data_seek()

    void mysql_data_seek(MYSQL_RES *result, unsigned long long offset)

    20.4.6.1 说明

    在一个查询结果集合中定位任意行。这要求结果集合结构包含查询的全部结果,这样mysql_data_seek()可以仅需与mysql_store_result()一起使用,不是与mysql_use_result()

    偏移量应该是从0到mysql_num_rows(result)-1范围的一个值。

    20.4.6.2 返回值

    无。

    20.4.6.3 错误

    无。

     

    20.4.7 mysql_debug()

    void mysql_debug(char *debug)

    20.4.7.1 说明

    用一个给定字符串做一个DBUG_PUSHmysql_debug()使用Fred Fish 调试库。为了使用这个函数,你必须编译客户库以支持调试。见G.1 调试一个MySQL服务器和节G.2 调试一个MySQL客户

    20.4.7.2 返回值

    无。

    20.4.7.3 错误

    无。

    20.4.7.4 范例

    下面所示的调用使得客户库在客户机器上的“/tmp/client.trace”中产生一个跟踪文件:

    mysql_debug("d:t:O,/tmp/client.trace");
     

    20.4.8 mysql_drop_db()

    int mysql_drop_db(MYSQL *mysql, const char *db)

    20.4.8.1 说明

    抛弃由db参数命名的数据库。

    这个函数不推荐,而最好使用mysql_query()发出一条SQL DROP DATABASE语句。

    20.4.8.2 返回值

    如果数据库成功地被破抛弃,零。如果发生一个错误,非零。

    20.4.8.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。 

    20.4.8.4 范例

    if(mysql_drop_db(&mysql, "my_database"))
      fprintf(stderr, "Failed to drop the database: Error: %s\n",
              mysql_error(&mysql));
     

    20.4.9 mysql_dump_debug_info()

    int mysql_dump_debug_info(MYSQL *mysql)

    20.4.9.1 说明

    指示服务者将一些调试信息写入日志文件。连接的用户对此必须有precess权限才能工作。

    20.4.9.2 返回值

    如果命令成功,零。如果发生一个错误,非零。

    20.4.9.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.10 mysql_eof()

    my_bool mysql_eof(MYSQL_RES *result)

    20.4.10.1 说明

    这个函数不推荐,而使用mysql_errno()mysql_error()

    mysql_eof()确定是否已经读到了一个结果集合的最后一行。

    如果你从成功的mysql_store_result()调用获得一个结果集合,客户程序用一个操作收到全部集合。在这种情况下,从mysql_fetch_row()返回一个NULL总是意味着已经到达了结果集合的尾部,没必要调用mysql_eof()

    在另一方面,如果你使用mysql_use_result()初始化一个结果集合的检索,该集合的行随着你重复调用mysql_fetch_row()一个一个地从服务器获得。因为在这个过程中在连接上可能发生一个错误,从mysql_fetch_row()返回一个NULL值并不意味着集合正常到达了尾部。在这种情况下,你能使用mysql_eof()确定发生了什么。如果到达结果集合的尾部,mysql_eof()返回非零值,并且如果发生一个错误,返回零。

    在时间上,mysql_eof()先于标准MySQL错误函数mysql_errno()mysql_error()。因为这些错误函数提供相同的信息,他们的使用更好mysql_eof(),它现在不建议使用。(事实上,他们提供更多的信息,因为mysql_eof()值返回一个布尔值,而错误函数指出当发生错误时的出错原因。)

    20.4.10.2 返回值

    如果发生一个错误,零。如果到达结果集合的结束,非零。

    20.4.10.3 错误

    无。

    20.4.10.4 范例

    下列例子显示你必须如何使用mysql_eof()

    mysql_query(&mysql,"SELECT * FROM some_table");
    result = mysql_use_result(&mysql);
    while((row = mysql_fetch_row(result)))
    {
        // do something with data
    }
    if(!mysql_eof(result))  // mysql_fetch_row() failed due to an error
    {
        fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
    }
    

    然而,你可以用标准MySQL错误函数完成同样的效果:

    mysql_query(&mysql,"SELECT * FROM some_table");
    result = mysql_use_result(&mysql);
    while((row = mysql_fetch_row(result)))
    {
        // do something with data
    }
    if(mysql_errno(&mysql))  // mysql_fetch_row() failed due to an error
    {
        fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
    }
     

    20.4.11 mysql_errno()

    unsigned int mysql_errno(MYSQL *mysql)

    20.4.11.1 说明

    对于由mysql指定的连接,mysql_errno()返回最近调用的可能成功或失败的API函数的错误代码。返回值零意味着没有错误发生。客户错误消息编号列出在MySQL“errmsg.h”头文件中。服务器错误消息编号列出在“mysqld_error.h”中。

    20.4.11.2 返回值:

    一个错误代码值。如果没有错误发生,零。

    20.4.11.3 错误

    无。

    20.4.12 mysql_error()

    char *mysql_error(MYSQL *mysql)

    20.4.12.1 说明

    对于由mysql指定的连接,mysql_errno()返回最近调用的可能成功或失败的API函数的错误代码。如果没有错误发生,返回空字符串("")。这意味着下列两个测试是等价的:

    if(mysql_errno(&mysql))
    {
        // an error occurred
    }
    
    if(mysql_error(&mysql)[0] != '\0')
    {
        // an error occurred
    }
    

    客户错误消息的语言可通过重新编译MySQL客户库来改变。目前,你能在几种不同的语言间选取错误消息。见9.1 MySQL支持什么语言?

    20.4.12.2 返回值

    一个描述错误的字符串。如果没有错误发生,空字符串。

    20.4.12.3 错误

    无。

     

    20.4.13 mysql_escape_string()

    unsigned int mysql_escape_string(char *to, const char *from, unsigned int length)

    20.4.13.1 说明

    把在from中的字符串编码为在一条SQL语句中可以发给服务器的转义的SQL字符串,将结果放在to中, 并且加上一个终止的空字节。编码的字符是NUL(ASCII 0)、‘\n’、‘\r’‘\’‘'’‘"’和Control-Z(见7.1 文字:如何写字符串和数字)。

    from指向的字符串必须是length个字节长。你必须分配to的缓冲区至少length*2+1个字节长。(在更坏的情况,每个字符可能需要使用2个字节被编码,并且你需要为终止空字节的空间) 当mysql_escape_string()返回时,to的内容将是空字符终止的字符串。返回值是编码后的字符串的长度,不包括终止空字符。

    20.4.13.2 范例

    char query[1000],*end;
    
    end = strmov(query,"INSERT INTO test_table values(");
    *end++ = '\'';
    end += mysql_escape_string(end,"What's this",11);
    *end++ = '\'';
    *end++ = ',';
    *end++ = '\'';
    end += mysql_escape_string(end,"binary data: \0\r\n",16);
    *end++ = '\'';
    *end++ = ')';
    
    if (mysql_real_query(&mysql,query,(unsigned int) (end - query)))
    {
       fprintf(stderr, "Failed to insert row, Error: %s\n",
               mysql_error(&mysql));
    }
    

    例子中所用的strmov()函数被包括在mysqlclient库中且功能类似于strcpy(),但是返回一个指向空终止的第一个参数的指针。

    20.4.13.3 返回值

    放进to的值的长度,不包括终止空字符。

    20.4.13.4 错误

    无。

     

    20.4.14 mysql_fetch_field()

    MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result)

    20.4.14.1 说明

    返回作为一个MYSQL_FIELD结构的一个结果集合的一个列的定义。重复调用这个函数在结果集合中检索所有关于列的信息。当没有剩下更多的字段时,mysql_fetch_field()返回NULL

    在每次你执行一个新的SELECT查询,mysql_fetch_field()被重置(reset)以返回有关第一列的信息。由mysql_fetch_field()返回的字段也受调用mysql_field_seek()的影响。

    如果你调用mysql_query()在一张表上执行一个SELECT,但是没调用mysql_store_result(),如果你调用mysql_fetch_field()询问一个BLOB字段的长度,MySQL返回缺省BLOB长度(8K字节)。(选择8K的长度是因为MySQL不知道BLOB的最大长度。这应该在某个时候是它可配置) 一旦你已经检索了结果集合,field->max_length包含了在特定查询中对于该列最大值的长度。

    20.4.14.2 返回值

    当前列的MYSQL_FIELD结构。如果没有列剩下,NULL

    20.4.14.3 错误

    无。

    20.4.14.4 范例

    MYSQL_FIELD *field;
    
    while((field = mysql_fetch_field(result)))
    {
        printf("field name %s\n", field->name);
    }
     

    20.4.15 mysql_fetch_fields()

    MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *result)

    20.4.15.1 说明

    返回一个结果集合的所有MYSQL_FIELD结构的数组。每个结构提供结果结合中一列的字段定义。

    20.4.15.2 返回值

    一个结果集合的所有MYSQL_FIELD结构的一个数组。

    20.4.15.3 错误

    无。

    20.4.15.4 范例

    unsigned int num_fields;
    unsigned int i;
    MYSQL_FIELD *fields;
    
    num_fields = mysql_num_fields(result);
    fields = mysql_fetch_fields(result);
    for(i = 0; i < num_fields; i++)
    {
       printf("Field %u is %s\n", i, fields[i].name);
    }
    

    20.4.16 mysql_fetch_field_direct()

    MYSQL_FIELD *mysql_fetch_field_direct(MYSQL_RES *result, unsigned int fieldnr)

    20.4.16.1 说明

    给定在一个结果集合中的一个列的字段编号fieldnr,返回作为MYSQL_FIELD结构的列的字段定义。你可以使用这个函数检索任意列的义。fieldnr的值应该在从0到mysql_num_fields(result)-1范围内。

    20.4.16.2 返回值

    指定列的MYSQL_FIELD结构。

    20.4.16.3 错误

    无。

    20.4.16.4 范例

    unsigned int num_fields;
    unsigned int i;
    MYSQL_FIELD *field;
    
    num_fields = mysql_num_fields(result);
    for(i = 0; i < num_fields; i++)
    {
        field = mysql_fetch_field_direct(result, i);
        printf("Field %u is %s\n", i, field->name);
    }
     

    20.4.17 mysql_fetch_lengths()

    unsigned long *mysql_fetch_lengths(MYSQL_RES *result)

    20.4.17.1 说明

    返回在结果集合内的当前行的列长度。如果你计划拷贝字段值,这个长度信息对优化也是有用的,因为你可以避免调用strlen()。另外,如果结果集合中包含二进制数据,你必须使用这个函数确定数据的大小,因为strlen()对包含空字符的任何字段返回不正确的结果。

    空列和包含NULL的列的长度值是零。为了看清如何区分这两种情况,见mysql_fetch_row()的说明。

    20.4.17.2 返回值

    表示每列大小的无符号长整数的一个数组(不包括任何终止空字符)。如果出现一个错误,NULL

    20.4.17.3 错误

    mysql_fetch_lengths()只对结果集合的当前行有效。如果你在调用mysql_fetch_row()之前或在检索出在结果中的所有以后,它返回NULL。

    20.4.17.4 范例

    MYSQL_ROW row;
    unsigned long *lengths;
    unsigned int num_fields;
    unsigned int i;
    
    row = mysql_fetch_row(result);
    if (row)
    {
        num_fields = mysql_num_fields(result);
        lengths = mysql_fetch_lengths(result);
        for(i = 0; i < num_fields; i++)
        {
             printf("Column %u is %lu bytes in length.\n", i, lengths[i]);
        }
    }
     

    20.4.18 mysql_fetch_row()

    MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

    20.4.18.1 说明

    检索一个结果集合的下一行。当在mysql_store_result()之后使用时,如果没有更多的行可见所时,mysql_fetch_row()返回NULL。当在mysql_use_result()之后使用时,当没有更多的行可检索时或如果出现一个错误,mysql_fetch_row()返回NULL。

    在行中值的数量由mysql_num_fields(result)给出。如果row保存了从一个对用mysql_fetch_row()调用返回的值,指向该值的指针作为row[0]row[mysql_num_fields(result)-1]来存取。在行中的NULL值由NULL指针指出。

    在行中字段值的长度可以通过调用mysql_fetch_lengths()获得。空字段和包含NULL的字段长度都是 0;你可以通过检查该值的指针区分他们。如果指针是NULL,字段是NULL;否则字段是空的。

    20.4.18.2 返回值

    下一行的一个MYSQL_ROW结构。如果没有更多的行可检索或如果出现一个错误,NULL。

    20.4.18.3 错误

    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.18.4 范例

    MYSQL_ROW row;
    unsigned int num_fields;
    unsigned int i;
    
    num_fields = mysql_num_fields(result);
    while ((row = mysql_fetch_row(result)))
    {
       unsigned long *lengths;
       lengths = mysql_fetch_lengths(result);
       for(i = 0; i < num_fields; i++)
       {
           printf("[%.*s] ", (int) lengths[i], row[i] ? row[i] : "NULL");
       }
       printf("\n");
    }
     

    20.4.19 mysql_field_count()

    unsigned int mysql_field_count(MYSQL *mysql)

    如果你正在使用一个比3.22.24早MySQL版本,你应该使用unsigned int mysql_num_fields(MYSQL *mysql)

    20.4.19.1 说明

    返回在连接上的最近查询的列的数量。

    这个函数一般用在mysql_store_result()返回NULL时(这样你没有结果设置指针)。在这种情况中,你能调用mysql_field_count()确定mysql_store_result()是否应该产生了一个非空的结果。这允许一个客户程序执行正确的操作,而不必知道查询是否是一条SELECT(或类SELECT)语句。下面显示的例子说明这怎样可以做到。

    20.4.51 为什么在mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    20.4.19.2 返回值

    在结果集合中表示字段数量字的一个无符号整数。

    20.4.19.3 错误

    无。

    20.4.19.4 范例

    MYSQL_RES *result;
    unsigned int num_fields;
    unsigned int num_rows;
    
    if (mysql_query(&mysql,query_string))
    {
        // error
    }
    else // query succeeded, process any data returned by it
    {
        result = mysql_store_result(&mysql);
        if (result)  // there are rows
        {
            num_fields = mysql_num_fields(result);
            // retrieve rows, then call mysql_free_result(result)
        }
        else  // mysql_store_result() returned nothing; should it have?
        {
            if(mysql_field_count(&mysql) == 0)
            {
                // query does not return data
                // (it was not a SELECT)
                num_rows = mysql_affected_rows(&mysql);
            }
            else // mysql_store_result() should have returned data
            {
                fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
            }
        }
    }
    

    另一个选择是用mysql_errno(&mysql)代替mysql_field_count(&mysql)调用。在这种情况中,你直接检查来自mysql_store_result()的一个错误而非从mysql_field_count()值来推断语句是否是一个SELECT

    20.4.20 mysql_field_seek()

    MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset)

    20.4.20.1 说明

    将字段光标设置到给定的偏移量。下一次调用mysql_fetch_field()将检索与该偏移量关联的列的字段定义。

    为了定位于行的起始,传递一个值为0的offset值。

    20.4.20.2 返回值

    字段光标的先前的值。

    20.4.20.3 错误

    无。

    20.4.21mysql_field_tell()

    MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES *result)

    20.4.21.1 说明

    返回用于最后一个mysql_fetch_field()的字段光标的位置。这个值可用作mysql_field_seek()的一个参数。

    20.4.21.2 返回值

    字段光标的当前偏移量。

    20.4.21.3 错误

    无。

    20.4.22 mysql_free_result()

    void mysql_free_result(MYSQL_RES *result)

    20.4.22.1 说明

    释放由mysql_store_result()mysql_use_result()、mysql_list_dbs()等为一个结果集合分配的内存。当你用完了一个结果集合时,你必须调用mysql_free_result()来释放它使用的内存。

    20.4.22.2 返回值

    无。

    20.4.22.3 错误

    无。

    20.4.23 mysql_get_client_info()

    char *mysql_get_client_info(void)

    20.4.23.1 说明

    返回代表客户库的版本的字符串。

    20.4.23.2 返回值

    代表MySQL客户库版本的一个字符串。

    20.4.23.3 错误

    无。

    20.4.24 mysql_get_host_info()

    char *mysql_get_host_info(MYSQL *mysql)

    20.4.24.1 说明

    返回描述正在使用的连接类型的字符串,包括服务其主机名。

    20.4.24.2 返回值

    表示服务器主机名者和连接类型的字符串。

    20.4.24.3 错误

    无。

     

    20.4.25 mysql_get_proto_info()

    unsigned int mysql_get_proto_info(MYSQL *mysql)

    20.4.25.1 说明

    返回当前连接使用的协议版本。

    20.4.25.2 返回值

    表示被当前连接使用的协议版本的一个无符号整数。

    20.4.25.3 错误

    无。

    20.4.26 mysql_get_server_info()

    char *mysql_get_server_info(MYSQL *mysql)

    20.4.26.1 说明

    返回表示服务器版本号的字符串。

    20.4.26.2 返回值

    表示服务器版本号的一个字符串。

    20.4.26.3 错误

    无。

    20.4.27 mysql_info()

    char *mysql_info(MYSQL *mysql)

    20.4.27.1 说明

    检索一个字符串,它提供有关最近执行的查询的信息,但是对下面列出的语句。对其他语句,mysql_info()返回NULL。字符串的格式随查询类型而变化,如下所述。数字仅仅是说明性的;字符串将包含对查询适当的值。

    INSERT INTO ... SELECT ...
    字符串格式: Records: 100 Duplicates: 0 Warnings: 0
    INSERT INTO ... VALUES (...),(...),(...)...
    字符串格式: Records: 3 Duplicates: 0 Warnings: 0
    LOAD DATA INFILE ...
    字符串格式: Records: 1 Deleted: 0 Skipped: 0 Warnings: 0
    ALTER TABLE
    字符串绳格式: Records: 3 Duplicates: 0 Warnings: 0
    UPDATE
    字符串格式: Rows matched: 40 Changed: 40 Warnings: 0

    注意,只有多个值在语句中指定,mysql_info()INSERT ... VALUES语句才返回非NULL值。

    20.4.27.2 返回值

    表示最近执行的查询的附加信息的一个字符串。如果得不到查询的任何信息,NULL。

    20.4.27.3 错误

    无。

    20.4.28 mysql_init()

    MYSQL *mysql_init(MYSQL *mysql)

    20.4.28.1 说明

    分配或初始化适合mysql_real_connect()的一个MYSQL对象。如果mysql是一个NULL指针,函数分配、初始化并且返回一个新对象。否则对象被初始化并且返回对象的地址。如果mysql_init()分配一个新对象,它将在调用mysql_close()关闭连接时被释放。

    20.4.28.2 返回值

    一个被初始化的MYSQL*句柄。如果没有足够的内存来分配一个新对象,NULL

    20.4.28.3 错误

    在内存不够的情况下,返回NULL

    20.4.29 mysql_insert_id()

    my_ulonglong mysql_insert_id(MYSQL *mysql)

    20.4.29.1 说明

    返回由先前的查询为一个AUTO_INCREMENT列生成的ID。在你执行一个INSERT查询向一个包含AUTO_INCREMENT字段的表中插入后,使用这个函数。

    注意,如果先前的查询不产生一个AUTO_INCREMENT值,mysql_insert_id()返回0。如果你需要在以后保存该值,必须在查询生成了该值后马上调用mysql_insert_id()

    也要注意,SQL的LAST_INSERT_ID()函数总是包含最近生成的AUTO_INCREMENT值,并且在查询之间不被重置,因为该函数的值在服务器端维护。

    20.4.29.2 返回值

    有先前的查询更新的AUTO_INCREMENT字段的值。如果在连接上没有先前的询问或如果查询没更新AUTO_INCREMENT值,返回零。

    20.4.29.3 错误

    无。

    20.4.30 mysql_kill()

    int mysql_kill(MYSQL *mysql, unsigned long pid)

    20.4.30.1 说明

    要求服务器杀死由pid指定的线程。

    20.4.30.2 返回值

    成功,零。如果出现一个错误,非零。

    20.4.30.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.31 mysql_list_dbs()

    MYSQL_RES *mysql_list_dbs(MYSQL *mysql, const char *wild)

    20.4.31.1 说明

    返回一个结果集合,它用在服务器上的匹配wild参数指定的简单正则表达式的数据库名组成。wild可以包含通配符字符“%”“_”,或可以是匹配所有的数据库的一个NULL指针。调用mysql_list_dbs()类似于执行查询SHOW databases [LIKE wild]

    你必须用mysql_free_result()释放结果集合。

    20.4.31.2 返回值

    成功,一个MYSQL_RES结果集合。如果出现一个错误,NULL。

    20.4.31.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.32 mysql_list_fields()

    MYSQL_RES *mysql_list_fields(MYSQL *mysql, const char *table, const char *wild)

    20.4.32.1 说明

    返回一个结果集合,它用在给定表中的匹配wild参数指定的简单正则表达式的列名组成。wild可以包含通配符字符“%”“_”,或可以是匹配所有列的一个NULL指针。调用mysql_list_fields()类似于执行查询SHOW COLUMNS FROM tbl_name [LIKE wild]

    注意,建议你使用SHOW COLUMNS FROM tbl_name而不是mysql_list_fields()

    你必须用mysql_free_result()释放结果集合。

    20.4.32.2 返回值

    成功,一个MYSQL_RES的结果集合。如果出线一个错误,NULL。

    20.4.32.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.33 mysql_list_processes()

    MYSQL_RES *mysql_list_processes(MYSQL *mysql)

    20.4.33.1 说明

    返回一个描述当前服务器线程的结果集合。这是与mysqladmin processlistSHOW PROCESSLIST查询报告的相同信息。

    你必须用mysql_free_result()释放结果集合。

    20.4.33.2 返回值

    成功,一个MYSQL_RES结果集合。如果发生一个错误,NULL。

    20.4.33.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.34 mysql_list_tables()

    MYSQL_RES *mysql_list_tables(MYSQL *mysql, const char *wild)

    20.4.34.1 说明

    返回一个结果集合,它用在当前数据库中的匹配wild参数指定的简单正则表达式的表名组成。wild可以包含通配符字符“%”“_”,或可以是匹配所有表的一个NULL指针。调用mysql_list_tables()类似于执行询问SHOW tables [LIKE wild]

    你必须用mysql_free_result()释放结果集合。

    20.4.34.2 返回值

    成功,一个MYSQL_RES结果集合。如果出现一个错误,NULL。

    20.4.34.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.35 mysql_num_fields()

    unsigned int mysql_num_fields(MYSQL_RES *result)

    unsigned int mysql_num_fields(MYSQL *mysql)

    第二中形式在MySQL 3.22.24或更新版本上不能工作。为了传递一个MYSQL* 参数,你必须使用unsigned int mysql_field_count(MYSQL *mysql)

    20.4.35.1 说明

    在结果集合中返回列的数量。

    注意,你也可以通过一个指向一个结果集合或一个连接句柄的指针获得列的数量。如果mysql_store_result()mysql_user_result()返回NULL,你将使用连接句柄(而这样你没有结果集合指针)。在这种情况下,你可以调用mysql_field_count()确定mysql_store_result()是否应该产生非空的结果。这允许客户程序采取成正确的行动,不必知道查询是否是一个SELECT(或类SELECT)语句。下面被显示出的例子说明这怎么可以被做。

    20.4.51 为什么在mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    20.4.35.2 返回值

    表示一个结果集合中字段数量的一个无符号整数。

    20.4.35.3 错误

    无。

    20.4.35.4 范例

    MYSQL_RES *result;
    unsigned int num_fields;
    unsigned int num_rows;
    
    if (mysql_query(&mysql,query_string))
    {
        // error
    }
    else // query succeeded, process any data returned by it
    {
        result = mysql_store_result(&mysql);
        if (result)  // there are rows
        {
            num_fields = mysql_num_fields(result);
            // retrieve rows, then call mysql_free_result(result)
        }
        else  // mysql_store_result() returned nothing; should it have?
        {
            if (mysql_errno(&mysql))
    	{
               fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
    	}
            else if (mysql_field_count(&mysql) == 0)
            {
                // query does not return data
                // (it was not a SELECT)
                num_rows = mysql_affected_rows(&mysql);
            }
        }
    }
    

    另一个选择(如果你知道你查询应该返回了一个结果结合)是用mysql_field_count(&mysql) = 0的一个检查来代替mysql_errno(&mysql)。这只会发生在出错了的情形。

    20.4.36 mysql_num_rows()

    my_ulonglong mysql_num_rows(MYSQL_RES *result)

    20.4.36.1 说明

    在结果集合中返回行的数量。

    mysql_num_rows()的使用取决于你是否使用mysql_store_result()mysql_use_result()返回一个结果集合。如果你使用mysql_store_result()mysql_num_rows()可以马上被调用。如果你使用mysql_use_result()mysql_num_rows()将不会返回正确的值,直到在结果集合中的所有行均被检索了。

    20.4.36.2 返回值

    在结果集合中行的数量。

    20.4.36.3 错误

    无。

    20.4.37 mysql_options()

    int mysql_options(MYSQL *mysql, enum mysql_option option, const char *arg)

    20.4.37.1 说明

    能用于设置额外连接选项并且影响一个连接的行为。这个函数可以被多次调用来设置多个选项。

    mysql_options()应该在mysql_init()之后和mysql_connect()mysql_real_connect()之前调用。

    option参数是你想要设置的选项;arg参数是选项的值。如果选项是一个整数,那么arg应该指向整数值。

    可能的选项值:

    选项 参数类型 功能
    MYSQL_OPT_CONNECT_TIMEOUT unsigned int * 以秒计的连接超时。
    MYSQL_OPT_COMPRESS 不使用 使用压缩的客户机/服务器协议。
    MYSQL_OPT_NAMED_PIPE 不使用 使用命名管道连接一个在NT上的MySQL服务器。
    MYSQL_INIT_COMMAND char * 当连接MySQL服务器时执行的命令。当重新连接时,将自动重新执行。
    MYSQL_READ_DEFAULT_FILE char * 从命名的选项文件而不是从“my.cnf”读取选项。
    MYSQL_READ_DEFAULT_GROUP char * “my.cnf”或用MYSQL_READ_DEFAULT_FILE指定的文件中的命名组中读取选项。

    注意,如果你使用MYSQL_READ_DEFAULT_FILEMYSQL_READ_DEFAULT_GROUP,总是读取client

    在选项文件中指定的组可能包含下列选项:

    compress 使用压缩的客户机/服务器协议。
    database 如果在连接命令中没有指定数据库,使用这个数据库。
    debug 调试选项
    host 缺省主机名
    init-command 在连接MySQL服务器时,执行的命令。当重新连接时,将自动重新执行。
    password 缺省口令
    pipe 使用命名管道连接一个在NT上的MySQL服务器。
    port 缺省端口号
    return-found-rows 告诉mysql_info()返回找到的行,而不是在使用UPDATE时,返回更新的行。
    socket 缺省套接字号
    timeout 以秒计的连接超时。
    user 缺省用户

    对于选项文件的更多信息,见4.15.4 选项文件

    20.4.37.2 返回值

    成功,零。如果你使用了未知的选项,非零。

    20.4.37.3 范例

    MYSQL mysql;
    
    mysql_init(&mysql);
    mysql_options(&mysql,MYSQL_OPT_COMPRESS,0);
    mysql_options(&mysql,MYSQL_READ_DEFAULT_GROUP,"odbc");
    if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0))
    {
        fprintf(stderr, "Failed to connect to database: Error: %s\n",
              mysql_error(&mysql));
    }
    

    上例请求客户使用压缩的客户机/服务器协议并且从my.cnf文件的odbc小节读取额外的选项。

    20.4.38 mysql_ping()

    int mysql_ping(MYSQL *mysql)

    20.4.38.1 说明

    检查到服务器的连接是否正在工作。如果它关闭了,自动尝试一个再连接。

    这个函数可被已经空闲很长时间的客户使用,来检查服务器是否关闭了连接并且如有必要重新连接。

    20.4.38.2 返回值

    如果服务器活着,零。如果出现一个错误,非零。

    20.4.38.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.39 mysql_query()

    int mysql_query(MYSQL *mysql, const char *query)

    20.4.39.1 说明

    执行指向空终止的字符串query的SQL查询,查询必须由一个单个的SQL语句组成。你不应该在语句后加上一个终止的分号(“;”)或\g

    mysql_query()不能被用于包含二进制数据的查询;相反你应该使用mysql_real_query()。(二进制数据可能包含“\0”字符,而mysql_query()将解释为查询字符串的结束。)

    20.4.39.2 返回值

    如果查询成功,零。如果出现一个错误,非零。

    20.4.39.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    到服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.40 mysql_real_connect()

    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 int client_flag)

    20.4.40.1 说明

    mysql_real_connect()试图建立到运行host的一个MySQL数据库引擎的一个连接。 mysql_real_connect()在你可以执行任何其他API函数之前必须成功地完成,除了mysql_get_client_info()

    参数指定如下:

    • 第一个参数应该是一个现存MYSQL结构的地址。在调用mysql_real_connect()之前,你必须调用mysql_init()初始化MYSQL结构。见下面的例子。
    • host值可以是一个主机名或一个IP地址。如果hostNULL或字符串"localhost",假定是到本地主机的一个连接。如果OS支持套接字(Unix)或命名管道(Win32),使用他们而不是TCP/IP与服务器连接。
    • user参数包含用户的MySQL登录ID。如果userNULL,假定是当前用户。在Unix下,它是当前登录名。在Windows ODBC下,必须明确地指定当前用户名字。见16.4 怎样填写ODBC管理程序中各种域
    • passwd参数为user包含口令。如果passwdNULL,只有在user表中对于有一个空白口令字段的用户的条目将被检查一个匹配。这允许数据库主管设置MySQL权限,使用户获得不同的口令,取决于他们是否已经指定一个口令。注意:不要试图在调用mysql_real_connect()前加密口令;口令加密自动被客户API处理。
    • db是数据库名。如果db不是NULL,连接将缺省数据库设置为这个值。
    • 如果port不是0,值对于TCP/IP连接将用作端口号。注意host参数决定连接的类型。
    • 如果unix_socket不是NULL,字符串指定套接字或应该被使用的命名管道。注意host参数决定连接的类型。
    • client_flag值通常是0,但是在很特殊的情况下可以被设置为下列标志的组合:
      标志名字 意味着的标志
      CLIENT_FOUND_ROWS 返回找到的(匹配的)行数,不是受到影响的行数。
      CLIENT_NO_SCHEMA 不允许db_name.tbl_name.col_name语法。这是为了ODBC;如果你使用该语法,导致语法分析器产生一个错误,它是为在一些ODBC程序捕捉错误是有用的。
      CLIENT_COMPRESS 使用压缩协议。
      CLIENT_ODBC 客户是一个ODBC客户。这使mysqld变得对ODBC更友好。

    20.4.40.2 返回值

    如果连接成功,一个 MYSQL*连接句柄。如果连接失败,NULL。对一个成功的连接,返回值与第一个参数值相同,除非你传递NULL给该参数。

    20.4.40.3 错误

    CR_CONN_HOST_ERROR
    不能连接MySQL服务器。
    CR_CONNECTION_ERROR
    不能连接本地MySQL服务器。
    CR_IPSOCK_ERROR
    不能创建一个IP套接字。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SOCKET_CREATE_ERROR
    不能创建一个Unix套接字。
    CR_UNKNOWN_HOST
    不能找到主机名的IP地址。
    CR_VERSION_ERROR
    由于试图使用一个不同协议版本的一个客户库与一个服务器连接导致的一个协议失配。如果你使用一个非常老的客户库连接一个没有使用--old-protocol选项启动的新服务器,这就能发生。
    CR_NAMEDPIPEOPEN_ERROR;
    不能在 Win32 上创建一个命名管道。
    CR_NAMEDPIPEWAIT_ERROR;
    不能在 Win32 上等待一个命名管道。
    CR_NAMEDPIPESETSTATE_ERROR;
    不能在 Win32 上得到一个管道处理器。

    20.4.40.4 范例

    MYSQL mysql;
    
    mysql_init(&mysql);
    if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0))
    {
        fprintf(stderr, "Failed to connect to database: Error: %s\n",
              mysql_error(&mysql));
    }
    

    20.4.41 mysql_real_query()

    int mysql_real_query(MYSQL *mysql, const char *query, unsigned int length)

    20.4.41.1 说明

    执行由query指向的SQL查询,它应该是一个length个字节的字符串。查询必须由一个单个的SQL语句组成。你不应该在语句后增加一个终止的分号(“;”)或\g

    对于包含二进制数据的查询,你必须使用mysql_real_query()而不是mysql_query(),因为二进制代码数据可能包含“\0”字符,而且,mysql_real_query()mysql_query()更快,因为它对查询字符串调用strlen()

    20.4.41.2 返回值

    如果查询成功,零。如果发生一个错误,非零。

    20.4.41.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.42 mysql_reload()

    int mysql_reload(MYSQL *mysql)

    20.4.42.1 说明

    要求MySQL服务器再次装载授权表。连接的用户必须拥有reload权限。

    不推荐这个函数。最好使用mysql_query()发出一条SQL FLUSH PRIVILEGES语句。

    20.4.42.2 返回值

    成功,零。如果发生一个错误,非零。

    20.4.42.3 错误

     
    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.43 mysql_row_seek()

    MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset)

    20.4.43.1 说明

    设置行光标为在结果集合中的任意行。这要求结果集合结构包含查询的全部结果,这样mysql_row_seek()只能与mysql_store_result()一起使用,而不与mysql_use_result()

    偏移量应该是调用mysql_row_tell()mysql_row_seek()返回的值。这个值不是简单地一个行号;如果你想要在结果集合内用行号来寻找行,使用mysql_data_seek()

    20.4.43.2 返回值

    行光标先前的值。该值可以被传递给随后的mysql_row_seek()调用。

    20.4.43.3 错误

    无。

    20.4.44 mysql_row_tell()

    MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result)

    20.4.44.1 说明

    返回为了mysql_fetch_row()的行光标的当前位置。这个值可以作为一个参数用于mysql_row_seek()

    你应该仅在mysql_store_result()后使用mysql_row_tell(),而不是在mysql_use_result()后。

    20.4.44.2 返回值

    行光标当前的偏移量。

    20.4.44.3 错误

    无。

     

    20.4.45 mysql_select_db()

    int mysql_select_db(MYSQL *mysql, const char *db)

    20.4.45.1 说明

    使得由db指定的数据库成为 在由mysql指定的连接上的缺省(当前)数据库。在随后的查询中,这个数据库对于不包括一个显式的数据库指定符的表的引用是缺省数据库。

    除非连接的用户能被认证允许使用数据库,否则mysql_select_db()失败。

    20.4.45.2 返回值

    成功,零。如果发生一个错误,非零。

    20.4.45.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.46 mysql_shutdown()

    int mysql_shutdown(MYSQL *mysql)

    20.4.46.1 说明

    让数据库服务器关闭。连接的用户必须有shutdown权限。

    20.4.46.2 返回值

    成功,零。如果出现一个错误,非零

    20.4.46.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。
     

    20.4.47 mysql_stat()

    char *mysql_stat(MYSQL *mysql)

    20.4.47.1 说明

    返回包含类似于由mysqladmin status命令提供的信息的一个字符串。它包括正常运行的秒数和正在运行线程、问题、再次装载和打开的表的数目。

    20.4.47.2 返回值

    描述服务器状态的一个字符串。如果出现一个错误,NULL。

    20.4.47.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.48 mysql_store_result()

    MYSQL_RES *mysql_store_result(MYSQL *mysql)

    20.4.48.1 说明

    对于成功地检索数据的每个询问(SELECTSHOWDESCRIBEEXPLAIN),你必须调用mysql_store_result()mysql_use_result()

    mysql_store_result()读取一个到客户的查询的全部结果,分配一个MYSQL_RES结构,并且把结果放进这个结构中。

    如果没有行返回,返回一个空集合集合。(空结果集合不同于一个NULL返回值。)

    一旦你调用了mysql_store_result(),你可以调用mysql_num_rows()找出结果集合中有多少行。

    你能调用mysql_fetch_row()从结果集合中取出行,或mysql_row_seek()mysql_row_tell()结果集合中获得或设置当前的行位置。

    一旦你用完结果集合,你必须调用mysql_free_result()

    20.4.51 为什么mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    20.4.48.2 返回值

    一个保存结果的MYSQL_RES结构。如果出现一个错误,NULL

    20.4.48.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.49 mysql_thread_id()

    unsigned long mysql_thread_id(MYSQL *mysql)

    20.4.49.1 说明

    返回当前连接的线程ID。这个值可用作mysql_kill()的一个参数以杀死线程。

    如果失去连接并且你用mysql_ping()重新连接,线程ID将改变。这意味着你不应该为以后使用获得线程ID并且存储它,当你需要它时,你应该获得它。

    20.4.49.2 返回值

    当前连接的线程 ID 。

    20.4.49.3 错误

    无。

    20.4.50 mysql_use_result()

    MYSQL_RES *mysql_use_result(MYSQL *mysql)

    20.4.50.1 说明

    对于成功地检索数据的每个查询(SELECTSHOWDESCRIBEEXPLAIN),你必须调用mysql_store_result()mysql_use_result()

    mysql_use_result()初始化一个结果集合的检索,但不真正将结果集合读入客户,就象mysql_store_result()那样。相反,必须通过调用mysql_fetch_row()单独检索出每一行,这直接从服务器读出结果而不在一个临时表或本地缓冲区中存储它,它比mysql_store_result()更快一点并且使用较少的内存。客户将只为当前行和一个可能最大max_allowed_packet字节的通信缓冲区分配内存。

    在另一方面,如果你在客户端对每一行正在做很多的处理,或如果输出被送到屏幕,用户可以打一个^S(停止滚动),你不应该使用mysql_use_result()。这将阻塞服务器并且阻止另外的线程从数据被取出的任何表中更新数据。

    当使用mysql_use_result()时,你必须执行mysql_fetch_row()直到返回一个NULL值,否则未取出的行将作为下一个查询的结果集合一部分被返回。如果你忘记做这个,C API将给出错误Commands out of sync; You can't run this command now

    你不能在一个从mysql_use_result()返回的结果集合上使用mysql_data_seek()mysql_row_seek()mysql_row_tell()mysql_num_rows()mysql_affected_rows(),你也不能发出另外的查询直到mysql_use_result()完成。(然而,在你取出所有的行以后,mysql_num_rows()将精确地返回取出的行数。)

    一旦你用完结果集合,你必须调用mysql_free_result()

    20.4.50.2 返回值

    一个MYSQL_RES结果结构。 如果发生一个错误发生,NULL。

    20.4.50.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.51 为什么在mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    有可能在一个对mysql_query()成功的调用后,mysql_store_result()返回NULL。当这发生时,它意味着出现了下列条件之一:

    • 有一个malloc()失败(例如,如果结果集合太大)。
    • 数据不能被读取(发生在连接上的一个错误)。
    • 查询没有返回数据(例如,它是一个INSERTUPDATEDELETE)。

    你总是可以通过调用mysql_field_count()检查语句是否应该产生非空的结果。如果mysql_field_count()返回零,结果是空的并且最后一个查询是不回值的一条语句(例如,一条INSERTDELETE)。如果mysql_field_count()返回非零值,语句应该产生非空的结果。见对mysql_field_count()描述的一个例子。

    你可以调用mysql_error()mysql_errno()测试一个错误。

    20.4.52 我能从查询中得到什么结果?

    除了由查询返回的结果集合外,你也能得到下列信息:

    • 当执行一条INSERTUPDATEDELETE时,mysql_affected_rows()返回受到最后一个查询影响的行数。一个例外是如果使用一条没有WHERE子句的DELETE,表被截断,它更快!在这种情况下,mysql_affected_rows()对于影响的记录数量返回零。
    • mysql_num_rows()返回结果集合中的行数。用mysql_store_result(),一旦mysql_store_result()返回,就可以调用mysql_num_rows()。用mysql_use_result(),只有在你已经用mysql_fetch_row()取出了所有行后,才能调用mysql_num_rows()
    • mysql_insert_id()返回由将一行插入一个具有AUTO_INCREMENT索引的表中的最后查询生成的ID。见20.4.29 mysql_insert_id()
    • 某些查询(LOAD DATA INFILE ...INSERT INTO ... SELECT ...、UPDATE)返回附加的信息。结果由返mysql_info()返回。对其返回字符串的格式,见mysql_info()的描述。如果没有附加的信息,mysql_info()返回一个NULL指针。

    20.4.53 我怎样能得到最后插入的行的唯一ID?

    如果你往包含一个具有AUTO_INCREMENT属性的列的一张表中插入一个记录,你能通过mysql_insert_id()函数获得最近生成的ID。

    你也可以通过在你传递给mysql_query()的一个查询字符串中使用LAST_INSERT_ID()函数检索出ID。

    你可以执行下列代码检查是否使用一个AUTO_INCREMENT索引。这也检查查询是否是有一个AUTO_INCREMENT索引的一条INSERT:

    if (mysql_error(&mysql)[0] == 0 &&
        mysql_num_fields(result) == 0 &&
        mysql_insert_id(&mysql) != 0)
    {
        used_id = mysql_insert_id(&mysql);
    }
    

    最近产生的ID是在一个按连接的基础上在服务器上进行维护,它将不被其他客户改变。如果你更新另外一个有非奇特(non-magic)值(即一个既不是NULL也不是0的值)的AUTO_INCREMENT列,它甚至将不被改变。

    如果你想要使用为一张表生成的ID并且把它插入到第2张表,你可以使用象这样的SQL语句:

    INSERT INTO foo (auto,text)
        VALUES(NULL,'text');              # generate ID by inserting NULL
    INSERT INTO foo2 (id,text)
        VALUES(LAST_INSERT_ID(),'text');  # use ID in second table
    

    20.4.54 链接C API的问题

    当与C API链接时,下列错误可能发生一些系统上:

    gcc -g -o client test.o -L/usr/local/lib/mysql -lmysqlclient -lsocket -lnsl
    
    Undefined        first referenced
     symbol          in file
    floor            /usr/local/lib/mysql/libmysqlclient.a(password.o)
    ld: fatal: Symbol referencing errors. No output written to client
    

    如果它发生在你的系统上,你必须通过在编译/链接命令行的最后增加-lm以包括数学库。

    20.4.55 怎样制作一个线程安全的客户

    客户“几乎”是线程安全的。最大的问题是在从套接字读取的“net.c”中的子程序不是中断安全的(interruot-safe)。这样做是这样考虑的,即你可能想有你自己的报警来中断一个长时间的读取服务器。

    标准客户库没有用线程选项来编译。

    为了获得一个线程安全的客户,使用-lmysys, -lstring-ldbug库和服务器使用的net_serv.o

    当使用一个线程化的客户时,你可以充分利用在“thr_alarm.c”文件中的函数。如果你正在使用来自mysys库的函数,你唯一必须记住的是首先调用my_init()

    所有函数除了mysql_real_connect()目前是线程安全的。下列注意事项描述怎样编译一个线程安全的客户库并且以一种线程安全的方式使用它。(下面对mysql_real_connect()的注意事项实际上也适用于mysql_connect(),但是因为mysql_connect()不提倡使用,无论如何你应该使用mysql_real_connect()。)

    为了使mysql_real_connect()是线程安全的,你必须用这个命令重新编译客户库:

    shell> CPPFLAGS=-DTHREAD_SAFE_CLIENT ./configure ...
    

    当链接标准客户时,你可能得到的某些因为未定义符号的错误,因为pthread库没有被缺省地包括。

    最终的“libmysqlclient.a”库现在是线程安全的。它的含义是只要2个线程不同时查询mysql_real_connect()返回的同一个连接句柄,客户代码是线程安全的;客户机/服务器协议在一个给定的连接上一次只允许一个请求。如果你想在同一个的连接上使用多个线程,你必须在mysql_query()mysql_store_result()调用组合附近有一个mutex锁定。一旦mysql_store_result()就绪,锁可以被释放并且其他线程可以查询同一个连接。(换句话说,不同的线程能使用不同被mysql_store_result()创建的MYSQL_RES指针,只要他们使用适当的锁定协议) 如果你用POSIX线程编程,你能使用pthread_mutex_lock()pthread_mutex_unlock()建立并且释放一个mutex锁定。

    如果你使用mysql_use_result()而不是mysql_store_result(),锁定将需要包围mysql_use_result()mysql_fetch_row()的调用,然而,它确实对不使用mysql_use_result()线程客户是最好的。

    20.5 MySQL Perl API

    本节记载了Perl DBI接口。以前的接口被称为mysqlperl。因为DBI/DBD现在是推荐的Perl接口,mysqlperl是过时的并且不在这里记载。

    20.5.1 DBIDBD::mysql

    DBI是对于很多数据库的一个通用接口。这意味着你能编写一个脚本,不用改变就能工作于很多数据库引擎。你需要为每种数据库类型定义了的一个数据库驱动程序(DBD)。对于MySQL,该驱动程序称为DBD::mysql

    有关Perl5 DBI的更多信息,请访问DBI网页并且阅读文档:

    http://www.symbolstone.org/technology/perl/DBI/index.html
    

    关于在Perl5定义的面向对象的编程(OOP)的更多信息,参见Perl OOP页:

    http://language.perl.com/info/documentation.html
    

    对于MySQL Perl支持的安装指令在4.10 Perl安装说明中给出。

    20.5.2 DBI接口

    可移植的DBI方法

    connect 建立到一个数据库服务器的连接
    disconnect 断开数据库服务器的连接
    prepare 准备执行一个SQL语句
    execute 执行准备好的语句
    do 准备并执行一个SQL语句
    quote 加引号于要插入的字符串或BLOB
    fetchrow_array 作为一个字段数组取出下一行
    fetchrow_arrayref 作为一个字段的引用数组取出下一行
    fetchrow_hashref 作为一个哈希表的引用取出下一行
    fetchall_arrayref 作为一个字段数组取出所有数据
    finish 完成一条语句并且让系统释放资源
    rows 返回受影响的行数
    data_sources 返回可在localhost上得到的数据库的数组
    ChopBlanks 控制fetchrow_*方法是否剥去空格
    NUM_OF_PARAMS 在准备的语句中的占位(placeholder-参数)的数目
    NULLABLE 其列可以是NULL
    trace 执行调试跟踪

    MySQL特定的方法

    insertid 最后一个AUTO_INCREMENT
    is_blob 该列是BLOB
    is_key 该列是键
    is_num 该列是数字的
    is_pri_key 该列是主键
    is_not_null 该列不能是NULL,见NULLABLE
    length 最大可能的列大小
    max_length 结果中实际上存在的最大列大小
    NAME 列名字
    NUM_OF_FIELDS 返回的字段数目
    table 在返回的集合中的表名
    type 所有的列类型

    Perl方法在下一节更详细地描述。用于方法返回值的变量有这些含义:

    $dbh
    数据库句柄
    $sth
    语句句柄
    $rc
    返回代码 (经常是一个状态)
    $rv
    返回值 (经常是一个行数)

    可移植DBI方法

    connect($data_source, $username, $password)
    使用connect方法使得一个数据库连接到数据源。$data_source值应该以DBI:driver_name:开始。以DBD::mysql驱动程序使用connect的例子:
    $dbh = DBI->connect("DBI:mysql:$database", $user, $password);
    $dbh = DBI->connect("DBI:mysql:$database:$hostname",
                        $user, $password);
    $dbh = DBI->connect("DBI:mysql:$database:$hostname:$port",
                        $user, $password);
    

    如果用户名或口令未定义,DBI分别使用DBI_USERDBI_PASS环境变量的值。如果你不指定主机名,它缺省为'localhost'。如果你不指定一个端口号,它缺省为MySQL的缺省端口(3306)。对Msql-Mysql-modules版本1.2009,$data_source值允许某些修饰词:

    mysql_read_default_file=file_name
    读取作为一个选项文件的“filename”。有关选项文件的信息,见4.15.4 选项文件
    mysql_read_default_group=group_name
    当读取选项文件时的缺省组通常是[client]组。通过指定mysql_read_default_group选项,缺省组变成[group_name]组。
    mysql_compression=1
    在客户和服务器之间使用压缩通信(MySQL 3.22.3或以后)。
    mysql_socket=/path/to/socket
    指定用于与服务器连接的Unix套接字的路径名(MySQL 3.21.15或以后)。

    可以给出多个修饰词;每一个必须前置一个分号。例如,如果你想要避免在一个DBI脚本中硬编码用户名和口令,你可以从用户的“~/.my.cnf”选项文件中取出它们,而不是这样编写你的connect调用:

    $dbh = DBI->connect("DBI:mysql:$database"
                    . ";mysql_read_default_file=$ENV{HOME}/.my.cnf",
                    $user, $password);
    

    这个调用将读取在选项文件中为[client]组而定义的选项。如果你想做同样的事情,但是也使用未[perl]组指定的选项,你可以使用:

    $dbh = DBI->connect("DBI:mysql:$database"
                    . ";mysql_read_default_file=$ENV{HOME}/.my.cnf"
                    . ";mysql_read_default_group=perl",
                    $user, $password);
      
    disconnect disconnect方法从数据库断开数据库句柄。它一般就在你从程序退出之前被调用。范例:
    $rc = $dbh->disconnect;
      
    prepare($statement) 准备一条由数据库引擎执行的SQL语句并且返回语句句柄($sth),你可以使用它调用execute方法。一般地你借助于prepareexecute来处理SELECT语句(和类SELECT语句,例如SHOWDESCRIBEEXPLAIN)。范例:
    $sth = $dbh->prepare($statement)
        or die "Can't prepare $statement: $dbh->errstr\n";
      
    execute execute方法执行一个准备好的语句。对非SELECT语句,execute返回受影响的行数。如果没有行受影响,execute返回"0E0",Perl将它视作零而不是真。对于SELECT语句,execute只是在数据库中启动SQL查询;你需要使用在下面描述的fetch_*方法之一检索数据。范例:
    $rv = $sth->execute
              or die "can't execute the query: $sth->errstr;
      
    do($statement) do方法准备并且执行一条SQL语句并且返回受影响的行数。如果没有行受到影响,do返回"0E0",Perl将它视为零而不是真。这个方法通常用于事先无法准备好(由于驱动程序的限制)或不需要执行多次(插入、删除等等)的非SELECT语句。范例:
    $rv = $dbh->do($statement)
            or die "Can't execute $statement: $dbh- >errstr\n";
        
    quote($string) quote方法被用来“转义”包含在string中的任何特殊字符并增加所需的外部的引号。范例:
    $sql = $dbh->quote($string)
    
    fetchrow_array 这个方法取下一行数据并且作为一个字段值数组返回它。范例:
    while(@row = $sth->fetchrow_array) {
            print qw($row[0]\t$row[1]\t$row[2]\n);
    }
    
    fetchrow_arrayref 这个方法取下一行数据并且作为一个对一个字段值数组的引用返回它。范例:
    while($row_ref = $sth->fetchrow_arrayref) {
            print qw($row_ref->[0]\t$row_ref->[1]\t$row_ref->[2]\n);
    }
    
    fetchrow_hashref 这个方法取一行数据并且返回包含字段名/值对的一个哈希表的一个引用。这个方法不如使用上述数组引用那样有效。范例:
    while($hash_ref = $sth->fetchrow_hashref) {
            print qw($hash_ref->{firstname}\t$hash_ref->{lastname}\t\
                    $hash_ref- > title}\n);
    }
      
    fetchall_arrayref 这个方法被用来获得从SQL语句被返回的所有数据(行)。它返回一个数组的引用,该数组包含对每行的数组的引用。你用一个嵌套循环来存取或打印数据。范例:
    my $table = $sth->fetchall_arrayref
                    or die "$sth->errstr\n";
    my($i, $j);
    for $i ( 0 .. $#{$table} ) {
            for $j ( 0 .. $#{$table->[$i]} ) {
                    print "$table->[$i][$j]\t";
            }
            print "\n";
    }
      
    finish 便名没有更多的数据将从这个语句句柄取出。你调用这个方法释放语句句柄和任何与它相关的系统资源。范例:
    $rc = $sth->finish;
    
    rows 返回由最后一条命令改变(更新、删除等)的行数。这通常用在非SELECTexecute语句之后。范例:
    $rv = $sth->rows; 
    
    NULLABLE 返回一个对一个布尔值数组的引用;对数组的每个成员,一个TRUE值表示该列可以包含NULL值。范例:
    $null_possible = $sth->{NULLABLE};
    
    NUM_OF_FIELDS 这个属性表明由一条SELECTSHOW FIELDS语句返回的字段数目。你可以用它检查一条语句是否返回了结果:一个零值表明一个象INSERTDELETEUPDATE的非SELECT语句。范例:
    $nr_of_fields = $sth->{NUM_OF_FIELDS};
      
    data_sources($driver_name) 这个方法返回一个数组,它包含在主机'localhost'上的MySQL服务器可得到的数据库名。范例:
    @dbs = DBI->data_sources("mysql");
    
    ChopBlanks 这个属性确定fetchrow_*方法是否将去掉返回值的头和尾的空白。范例:
    $sth->{'ChopBlanks'} =1;
      
    trace($trace_level)   trace($trace_level, $trace_filename) trace方法开启或关闭跟踪。当作为一个DBI类方法调用时,它影响对所有句柄的跟踪。当作为一个数据库或语句句柄方法调用时,它影响对给定句柄的跟踪(和句柄的未来子孙)。设置$trace_level为2以提供详细的踪迹信息,设置$trace_level为0以关闭跟踪。踪迹输出缺省地输出到标准错误输出。如果指定$trace_filename,文件以添加模式打开并且所有跟踪的句柄的手被写入该文件。范例:
    DBI->trace(2);                # trace everything
    DBI->trace(2,"/tmp/dbi.out"); # trace everything to /tmp/dbi.out
    $dth->trace(2);               # trace this database handle
    $sth->trace(2);               # trace this statement handle
    

    你也可以通过设置DBI_TRACE环境变量开启DBI跟踪。将它设置为等价于调用DBI->(value)的数字值,将它设置为等价于调用DBI->(2,value)的路径名。

    MySQL特定的方法

    下面显示的方法是MySQL特定的并且不是DBI标准的部分。他们中有几个现在不建议使用:is_blobis_keyis_numis_pri_keyis_not_nulllength、max_length和table。这些已有DBI标准的另一种方法存在,他们在下面说明。

    insertid
    如果你使用MySQLAUTO_INCREMENT功能,新的自动加1的值将存储在这里。范例:
    $new_id = $sth->{insertid};
    

    作为另一种选择,你可以使用$dbh->{'mysql_insertid'}

    is_blob
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列是一个BLOB。范例:
    $keys = $sth->{is_blob};
      
    is_key
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列是键。范例:
    $keys = $sth->{is_key};
    
    is_num
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列包含数字值。范例:
    $keys = $sth->{is_key};
      
    is_pri_key
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列是主键。范例:
    pri_keys = $sth->{is_pri_key}; 
      
    is_not_null
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个FALSEE值表明该列可以包含NULL值。范例:
    $not_nulls = $sth->{is_not_null};
    

    is_not_null不建议使用;最好使用NULLABLE属性(在上面描述了),因为那是一个 DBI 标准。

    length
     
    max_length
    这些方法的每个返回一个对列大小数组的引用。length数组指出每列可以有的最大可能的尺寸 (如在表描述中声明的)。max_length数组指出在结果表中实际存在的最大尺寸。范例:
    $lengths = $sth->{length};
    $max_lengths = $sth->{max_length};
      
    NAME
    返回一个对一个列名数组的引用。范例:
    $names = $sth->{NAME};
    
    table
    返回一个对一个表名数组的引用。范例:
    $tables = $sth->{table};
    
    type
    返回一个对一个列类型数组的引用。范例:
    $types = $sth->{type};
    

    20.5.3 更多的DBI/DBD信息

    你可以使用perldoc命令得到更多的关于DBI的信息。

    perldoc DBI
    perldoc DBI::FAQ
    perldoc DBD::mysql
    

    你也可以使用pod2man、pod2html等工具转换到其他格式。

    而且你当然可以在DBI网页中找到最新的DBI信息:

    http://www.symbolstone.org/technology/perl/DBI/index.html
    

    20.6 MySQL Eiffel包装

    MySQL Contrib目录包含Michael Ravits编写的一个Eiffel包装程序。

    你也能在这里找到:http://www.netpedia.net/hosting/newplayer/

    20.7 MySQL Java连接(JDBC)

    有2个为MySQL支持的JDBC驱动程序(twz和mm驱动程序)。你可以在http://www.mysql.com/Contrib找到这些的一个拷贝。对于文档,请教任何JDBC文档和驱动程序本身拥有的针对MySQL特定功能的文档。

    20.8 MySQL PHP API

    PHP是一个服务器端、HTML嵌入式脚本语言,可以用来创建动态网页。它包含对存取若干数据库的支持,包括MySQL。PHP可以作为一个单独的程序运行,或编译为与Apache服务器一起使用的一个模块。

    分发和文档可在PHP网站得到。

    20.9 MySQL C++ APIs

    MySQL Contrib 目录中可得到两个API。

    20.10 MySQL Python API

    MySQL Contrib 目录包含Joseph Skinner编写的一个Python接口。

    你也可以使用对iODBC的Python接口来存取一个MySQL服务器。mxODBC

    20.11 MySQL TCL API

     

    http://www.yesky.com/imagesnew/software/mysql/manual_Clients.html

     

    展开全文
  • MySQL 代码分发中的很多客户是用 C 编写的如果你正在寻找演示怎样使用 C API 例子。 例如,大多数其他客户 API 除了 Java 所有 ) 都使用 mysqlclient 库与 MySQL 服务器通信。这意味着。能利用很多被其他客户...

    原创  20 个 MySQL客户工具和API 收藏

    C API 代码是随 MySQL 分发的被包含在 mysqlclient 库且允许 C 顺序存取一个数据库。

    看一下这些客户顺序。 MySQL 源代码分发中的很多客户是用 C 编写的如果你正在寻找演示怎样使用 C API 例子。

    例如,大多数其他客户 API 除了 Java 所有 ) 都使用 mysqlclient 库与 MySQL 服务器通信。这意味着。能利用很多被其他客户顺序使用的同一环境变量,因为他从库中引用。对这些变量的一张表,见 12.1 不同的 MySQL 顺序的概述。

    简单地增加缺省的最大限制并不造成更多被消耗。该尺寸检查主要是一个对错误的查询和通讯包的检查。 客户有一个最大通讯缓冲区大小。初始分配的缓冲区大小 ( 16K 字节 ) 自动地增加到最大尺寸 ( 缺省的最大值是 24M 因为缓冲区大小只是按保证需求而被增加。

    如果你包括大到 16M 数据的 BLOB 值,通讯缓冲区必需足够大以便一个单独的 SQL 语句 ( 对客户 - 服务器传输 ) 和一行返回的数据 ( 对服务器 - 客户传输 ) 每个线程的通讯缓冲区主动态扩大到最大限制来处置任何查询或行。例如。必需有一个至少 16M 通讯缓冲区限制 ( 服务器和客户两端 ) 客户的缺省最大值是 24M 但是服务器端的缺省最大值是 1M 可以在服务器启动时通过改变 max_allowed_packet 参数的值来改变它见 10.2.3 调节服务器参数。

    与一个连接相关的缓冲区的大小没被减少,MySQL 服务器在每个查询后缩小每个通讯缓冲区到 net_buffer_length 个字节。对客户。直到连接被关闭,此时客户内存被回收。

    应该用 --with-thread-safe-cli 编译 MySQL C API 这将使 C API 线程对每个连接更安全。可以让 2 个线程共享相同的连接,如果你用线程的编程。只要如果你做下列事情:

    两个线程不能同时在同一个连接上发送查询到 MySQL 特别是必需保证在一个 mysql_queri 和 mysql_store_result 之间没有其他线程正在使用同一个连接。

    许多线程能存取用 mysql_store_result 检索进去的不同结果集合。

    直到结果集合被关闭。 如果你使用 mysql_use_result 必需保证没有其他线程在同一个连接上正在询问任何东西。

    20.2 C API 数据类型

    MYSQL

    被用于几乎所有的 MySQL 函数。 这个结构表示对一个数据库连接的句柄。

    MYSQL_RES

    SHOW, 这个结构代表返回行的一个查询的 SELECT. DESCRIBE, EXPLA IN 结果。从查询返回的信息在本章下文称为结果集合。

    MYSQL_ROW

    不能将这些视为空终止串,这是一个行数据的类型平安 ( type-saf 表示。当前它实现为一个计数字节的字符串数组。如果字段值可能包括二进制数据。因为这样的值可以在内部包括空字节 ) 行通过调用 mysql_fetch_row 获得。

    MYSQL_FIELD

    例如字段名、类型和大小。其成员在下面更详细地描述。可以通过重复调用 mysql_fetch_field 对每一列获得 MYSQL_FIELD 结构。字段值不是这个结构的局部;被包含在一个 MYSQL_ROW 结构中。 这个结构包括字段信息。

    MYSQL_FIELD_OFFSET

    从 0 开始。 这是一个相对一个 MySQL 字段表的偏移量的类型平安的表示。由 mysql_field_seek 使用。偏移量是一行以内的字段编号。

    my_ulonglong

    试图打印类型 my_ulonglong 值将不工作。为了打印出这样的值,该类型用于行编号和 mysql_affected_row mysql_num_row 和 mysql_insert_id 这种类型提供 0 1.84e19 一个范围。一些系统上。将它变换到 unsign long 并且使用一个 %lu 打印格式。例如:

    unsign long mysql_num_row result printf Number of rows: %lu/n".;

    转载请标明出处: http://blog.csdn.net/gto889qq 本文来自 CSDN 博客。x

    展开全文
  • 20 MySQL客户工具和API

    千次阅读 2006-07-10 10:06:00
    http://www.yesky.com/imagesnew/software/mysql/manual_Clients.html 20 MySQL客户工具和API20.1 MySQL C APIC API代码是随MySQL分发的,它被包含在mysqlclient库且允许C程序存取...如果你正在寻找演示怎样使用C API

    http://www.yesky.com/imagesnew/software/mysql/manual_Clients.html

     

    20 MySQL客户工具和API

    20.1 MySQL C API

    C API代码是随MySQL分发的,它被包含在mysqlclient库且允许C程序存取一个数据库。

    在 MySQL源代码分发中的很多客户是用C编写的。如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。

    大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服务器通信。这意味着,例如,你能利用很多被其他客户程序使用的同一环境变量,因为他们从库中引用。对这些变量的一张表,见12.1 不同的MySQL程序的概述

    客户有一个最大通讯缓冲区大小。初始分配的缓冲区大小(16K字节) 自动地增加到最大尺寸(缺省的最大值是24M)。因为缓冲区大小只是按保证需求而被增加,简单地增加缺省的最大限制并不造成更多被消耗。该尺寸检查主要是一个对错误的查询和通讯包的检查。

    通讯缓冲区必须足够大以便一个单独的SQL语句(对客户-服务器传输)和一行返回的数据(对服务器-客户传输)。每个线程的通讯缓冲区被动态扩大到最大限制来处理任何查询或行。例如,如果你包含大到16M数据的BLOB值,你必须有一个至少16M通讯缓冲区限制(在服务器和客户两端)。客户的缺省最大值是24M,但是在服务器端的缺省最大值是1M。你可以在服务器启动时通过改变max_allowed_packet参数的值来改变它。见10.2.3 调节服务器参数

    MySQL服务器在每个查询后缩小每个通讯缓冲区到net_buffer_length个字节。对客户,与一个连接相关的缓冲区的大小没被减少,直到连接被关闭,在此时客户内存被回收。

    如果你用线程的编程,你应该用--with-thread-safe-client编译MySQL C API,这将使C API线程对每个连接更安全。你可以让2个线程共享相同的连接,只要如果你做下列事情:

    两个线程不能同时在同一个连接上发送查询到MySQL。特别是你必须保证在一个mysql_query()mysql_store_result()之间没有其他线程正在使用同一个连接。
    许多线程能存取用mysql_store_result()检索出来的不同结果集合。
    如果你使用mysql_use_result,你必须保证没有其他线程在同一个连接上正在询问任何东西,直到结果集合被关闭。

    20.2 C API数据类型

    MYSQL
    这个结构表示对一个数据库连接的句柄,它被用于几乎所有的MySQL函数。
    MYSQL_RES
    这个结构代表返回行的一个查询的(SELECT, SHOW, DESCRIBE, EXPLAIN)的结果。从查询返回的信息在本章下文称为结果集合
    MYSQL_ROW
    这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的字符串数组。(如果字段值可能包含二进制数据,你不能将这些视为空终止串,因为这样的值可以在内部包含空字节) 行通过调用mysql_fetch_row()获得。
    MYSQL_FIELD
    这个结构包含字段信息,例如字段名、类型和大小。其成员在下面更详细地描述。你可以通过重复调用mysql_fetch_field()对每一列获得MYSQL_FIELD结构。字段值不是这个结构的部分;他们被包含在一个MYSQL_ROW结构中。
    MYSQL_FIELD_OFFSET
    这是一个相对一个MySQL字段表的偏移量的类型安全的表示。(由mysql_field_seek()使用。) 偏移量是在一行以内的字段编号,从0开始。
    my_ulonglong
    该类型用于行编号和mysql_affected_rows()mysql_num_rows()mysql_insert_id()。这种类型提供01.84e19的一个范围。在一些系统上,试图打印类型my_ulonglong的值将不工作。为了打印出这样的值,将它变换到unsigned long并且使用一个%lu打印格式。例如:
    printf (Number of rows: %lu/n", (unsigned long) mysql_num_rows(result));
    

    MYSQL_FIELD结构包含列在下面的成员:

    char * name
    字段名,是一个空结尾的字符串。
    char * table
    包含该字段的表的名字,如果它不是可计算的字段。对可计算的字段,table值是一个空字符串。
    char * def
    这字段的缺省值,是一个空结尾的字符串。只要你使用,只有你使用mysql_list_fields()才可设置它。
    enum enum_field_types type
    字段类型。type值可以是下列之一:
    类型值 类型含义
    FIELD_TYPE_TINY TINYINT字段
    FIELD_TYPE_SHORT SMALLINT字段
    FIELD_TYPE_LONG INTEGER字段
    FIELD_TYPE_INT24 MEDIUMINT字段
    FIELD_TYPE_LONGLONG BIGINT字段
    FIELD_TYPE_DECIMAL DECIMALNUMERIC字段
    FIELD_TYPE_FLOAT FLOAT字段
    FIELD_TYPE_DOUBLE DOUBLEREAL字段
    FIELD_TYPE_TIMESTAMP TIMESTAMP字段
    FIELD_TYPE_DATE DATE字段
    FIELD_TYPE_TIME TIME字段
    FIELD_TYPE_DATETIME DATETIME字段
    FIELD_TYPE_YEAR YEAR字段
    FIELD_TYPE_STRING 字符串(CHARVARCHAR)字段
    FIELD_TYPE_BLOB BLOBTEXT字段(使用max_length决定最大长度)
    FIELD_TYPE_SET SET字段
    FIELD_TYPE_ENUM ENUM字段
    FIELD_TYPE_NULL NULL- 类型字段
    FIELD_TYPE_CHAR 不推荐;使用FIELD_TYPE_TINY代替

    你可以使用IS_NUM()宏来测试字段是否有一种数字类型。将type值传给IS_NUM()并且如果字段是数字的,它将计算为TRUE:

    if (IS_NUM(field->type))
        printf("Field is numeric/n");
    
    unsigned int length
    字段宽度,在表定义中指定。
    unsigned int max_length
    对结果集合的字段的最大宽度(对实际在结果集合中的行的最长字段值的长度)。如果你使用mysql_store_result()mysql_list_fields(),这包含字段最大长度。如果你使用mysql_use_result(),这个变量的值是零。
    unsigned int flags
    字段的不同位标志。flags值可以是零个或多个下列位设置:
    标志值 标志含义
    NOT_NULL_FLAG 字段不能是NULL
    PRI_KEY_FLAG 字段是一个主键的一部分
    UNIQUE_KEY_FLAG 字段是一个唯一键的一部分
    MULTIPLE_KEY_FLAG 字段是一个非唯一键的一部分。
    UNSIGNED_FLAG 字段有UNSIGNED属性
    ZEROFILL_FLAG 字段有ZEROFILL属性
    BINARY_FLAG 字段有BINARY属性
    AUTO_INCREMENT_FLAG 字段有AUTO_INCREMENT属性
    ENUM_FLAG 字段是一个ENUM(不推荐)
    BLOB_FLAG 字段是一个BLOBTEXT(不推荐)
    TIMESTAMP_FLAG 字段是一个TIMESTAMP(不推荐)

    BLOB_FLAGENUM_FLAGTIMESTAMP_FLAG标志的使用是不推荐的,因为他们指出字段的类型而非它的类型属性。对FIELD_TYPE_BLOBFIELD_TYPE_ENUMFIELD_TYPE_TIMESTAMP,最好是测试field->type。下面例子演示了一个典型的flags值用法:

    if (field->flags & NOT_NULL_FLAG)
        printf("Field can't be null/n");
    

    你可以使用下列方便的宏决来确定flags值的布尔状态:

    IS_NOT_NULL(flags) 真,如果该字段被定义为NOT NULL
    IS_PRI_KEY(flags) 真,如果该字段是一个主键
    IS_BLOB(flags) 真,如果该字段是一个BLOBTEXT(不推荐;相反测试field->type
    unsigned int decimals
    对数字字段的小数位数。

    20.3 C API函数概述

    在 C API 中可用的函数列在下面,并且在下一节更详细地描述。见20.4 C API函数描述

    mysql_affected_rows() 返回被最新的UPDATE, DELETEINSERT查询影响的行数。
    mysql_close() 关闭一个服务器连接。
    mysql_connect() 连接一个MySQL服务器。该函数不推荐;使用mysql_real_connect()代替。
    mysql_change_user() 改变在一个打开的连接上的用户和数据库。
    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_host_info() 返回一个描述连接的字符串。
    mysql_get_proto_info() 返回连接使用的协议版本。
    mysql_get_server_info() 返回服务器版本号。
    mysql_info() 返回关于最近执行得查询的信息。
    mysql_init() 获得或初始化一个MYSQL结构。
    mysql_insert_id() 返回有前一个查询为一个AUTO_INCREMENT列生成的ID。
    mysql_kill() 杀死一个给定的线程。
    mysql_list_dbs() 返回匹配一个简单的正则表达式的数据库名。
    mysql_list_fields() 返回匹配一个简单的正则表达式的列名。
    mysql_list_processes() 返回当前服务器线程的一张表。
    mysql_list_tables() 返回匹配一个简单的正则表达式的表名。
    mysql_num_fields() 返回一个结果集合重的列的数量。
    mysql_num_rows() 返回一个结果集合中的行的数量。
    mysql_options() 设置对mysql_connect()的连接选项。
    mysql_ping() 检查对服务器的连接是否正在工作,必要时重新连接。
    mysql_query() 执行指定为一个空结尾的字符串的SQL查询。
    mysql_real_connect() 连接一个MySQL服务器。
    mysql_real_query() 执行指定为带计数的字符串的SQL查询。
    mysql_reload() 告诉服务器重装授权表。
    mysql_row_seek() 搜索在结果集合中的行,使用从mysql_row_tell()返回的值。
    mysql_row_tell() 返回行光标位置。
    mysql_select_db() 连接一个数据库。
    mysql_shutdown() 关掉数据库服务器。
    mysql_stat() 返回作为字符串的服务器状态。
    mysql_store_result() 检索一个完整的结果集合给客户。
    mysql_thread_id() 返回当前线程的ID。
    mysql_use_result() 初始化一个一行一行地结果集合的检索。

    为了连接服务器,调用mysql_init()以初始化一个连接处理器,然后用该处理器调用mysql_real_connect()(还有其他信息例如主机名、用户名和口令)。当你用该连接完成工作后,调用mysql_close()终止它。

    当一个连接活跃时,客户可以用mysql_query()mysql_real_query()将SQL查询发送到服务器。两者的差别是mysql_query()期望查询作为一个空结尾的字符串来指定而mysql_real_query()期望一个计数的字符串。如果字符串包含二进制数据(它可以包括空字节),你必须使用mysql_real_query()

    对与每个非--SELECT查询(例如,INSERTUPDATEDELETE等),你可以调用mysql_affected_rows()知道有多少行受到影响(改变)。

    对于SELECT查询,你作为一个结果集合来检索选择的行。(注意一些语句是类SELECT的,他们返回行。这些包括SHOWDESCRIBEEXPLAIN。他们应该象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()的一个优点是既然行均被客户取到,你不仅能顺序存取行,你也能mysql_data_seek()mysql_row_seek()在结果集合中前后移动以改变在结果集合中的当前行位置。你也能通过调用mysql_num_rows()知道有多少行。另一方面,mysql_store_result()的内存需求对较大结果集合可能很高,并且你最可能遇到out-of-memory情况。

    mysql_use_result()的一个优点是客户为结果集合需要较少的内存,因为它一次只是维持一行(并且因为有较少的分配开销,mysql_use_result()能更快些)。缺点是你必须尽快处理每一行以避免困住服务器,你不必再结果集合中随意存取行(你只能顺序存取行),而且你不知道在结果集合中有多少行,直到你检索全部结果。还有,你必须检索出所有行,即使你在检索中途确定你已找到了想寻找的信息。

    API使得客户正确应答查询成为可能(仅检索必要的行),不用知道查询是否是一个SELECT。你可以通过在mysql_query()(或mysql_real_query())之后调用mysql_store_result()做到。如果结果集合调用成功并且查询是一个SELECT,你能读取行。如果结果集合调用,调用mysql_field_count()确定结果是否是实际期望的。如果mysql_field_count()返回0,查询没有返回数据(表明它是一个INSERTUPDATE、DELETE等),所以不期望返回行。如果mysql_field_count()是非零,查询应该有返回行,但是没有。这表明查询是一个失败的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()函数提供错误信息的存取。他们返回最近调用的可能成功或失败的函数的错误代码或错误消息,允许你确定何时发生一个错误和什么错误。

    20.4 C API函数描述

    在下面的描述中,一个NULL参数或返回值含义是在C编程语言环境的NULL,不是一个MySQL NULL值。

    返回一个值的函数一般返回一个指针或一个整数。除非另外指定,返回一个指针的函数返回一个非 NULL值表明成功,或一个NULL值表明一个错误,而返回一个整数的函数返回零表示成功,或非零表示一个错误。注意,“非零”只有这个含义。除非函数描述另外说明,不要测试一个零以外的其他值:

    if (result)                   /* 正确 */
        ... error ...
    
    if (result < 0)               /* 不正确 */
        ... error ...
    
    if (result == -1)             /* 不正确 */
        ... error ...
    
    

    当函数返回一个错误时,函数描述的错误小节列出错误可能的类型。你可以调用mysql_errno()找出发生了这些重的哪一个。错误的字符串表示可以调用mysql_error()获得。

    20.4.1 mysql_affected_rows()

    my_ulonglong mysql_affected_rows(MYSQL *mysql)

    20.4.1.1 说明

    返回受到最后一个UPDATEDELETEINSERT查询影响(变化)的行数。可以在针对UPDATEDELETEINSERT语句的mysql_query()之后立即调用。对于SELECT语句,mysql_affected_rows()的功能于mysql_num_rows()相同。

    mysql_affected_rows()目前以一个宏(macro)来实现。

    20.4.1.2 返回值

    大于零的一个整数表示受到影响或检索出来的行数。零表示没有匹配查序中WHERE子句的记录或目前还没有查询被执行。-1表示查询返回一个错误,或对于一个SELECT查询,mysql_affected_rows()在调用mysql_store_result()之前被调用。

    20.4.1.3 错误

    没有。

    20.4.1.4 范例

    mysql_query(&mysql,"UPDATE products SET cost=cost*1.25 WHERE group=10");
    printf("%d products updated",mysql_affected_rows(&mysql));
     

    20.4.2 mysql_close()

    void mysql_close(MYSQL *mysql)

    20.4.2.1 说明

    关闭一个以前打开了的连接。如果句柄由mysql_init()mysql_connect()自动分配,mysql_close()也释放被mysql指向的连接句柄。

    20.4.2.2 返回值

    没有。

    20.4.2.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.3 mysql_connect()

    MYSQL *mysql_connect(MYSQL *mysql, const char *host, const char *user, const char *passwd)

    20.4.3.1 说明

    该函数不推荐使用,而更好使用mysql_real_connect()

    mysql_connect()试图建立一个对运行在host的一个MySQL数据库引擎的连接。mysql_connect()必须在你能执行其他API函数之前成功地完成,除了mysql_get_client_info()

    参数的含义与mysql_connect()相应的参数相同,不同的是连接参数可以是NULL。在这种情况下,C API 自动为连接结构分配内存,并且当你调用mysql_close(),释放它。这种方法的缺点是如果连接失败,你不能检索出一条错误消息。(为了从mysql_errno()mysql_error()得到错误信息,你必须提供一个有效的MYSQL指针。)

    20.4.3.2 返回值

    mysql_real_connect()

    20.4.3.3 错误

    mysql_real_connect()

    20.4.4mysql_change_user()

    my_bool mysql_change_user(MYSQL *mysql, const char *user, const char *password, const char *db)

    20.4.4.1 说明

    改变用户并且使得由db指定数据库成为由mysql指定的连接上的缺省(当前)数据库。在随后的查询中,这个数据库是不包括一个明确的数据库指定符的表引用的缺省值。

    这个函数功能在MySQL 3.23.3中引入。

    除非连接的用户能被认证或如果他没有权限使用数据库,mysql_change_user()失败。在这种情况下,用户和数据库都没被改变。

    如果你不想有一个缺省数据库,db参数可以被设置为NULL

    20.4.4.2 返回值

    成功,零。如果发生一个错误发生,非零。

    20.4.4.3 错误

    与你能从mysql_real_connect()得到的相同。

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。
    ER_UNKNOWN_COM_ERROR
    MySQL服务器未实现这个命令(可能是一个老的服务器)
    ER_ACCESS_DENIED_ERROR
    用户或口令错误。
    ER_BAD_DB_ERROR
    数据库不存在。
    ER_DBACCESS_DENIED_ERROR
    用户没有数据库的存取权利。
    ER_WRONG_DB_NAME
    数据库名字太长。

    20.4.4.4 范例

    if (mysql_change_user(&mysql, "user", "password", "new_database"))
    {
       fprintf(stderr, "Failed to change user.  Error: %s/n",
               mysql_error(&mysql));
    }
     

    20.4.5 mysql_create_db()

    int mysql_create_db(MYSQL *mysql, const char *db)

    20.4.5.1 说明

    创建由db参数命名的数据库。

    这个函数不推荐,而最好使用mysql_query()发出一条SQL CREATE DATABASE语句。

    20.4.5.2 返回值

    如果数据库成功地被创造,零。如果发生一个错误,非零。

    20.4.5.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。 

    20.4.5.4 范例

    if(mysql_create_db(&mysql, "my_database"))
    {
       fprintf(stderr, "Failed to create new database.  Error: %s/n",
               mysql_error(&mysql));
    }
     

    20.4.6 mysql_data_seek()

    void mysql_data_seek(MYSQL_RES *result, unsigned long long offset)

    20.4.6.1 说明

    在一个查询结果集合中定位任意行。这要求结果集合结构包含查询的全部结果,这样mysql_data_seek()可以仅需与mysql_store_result()一起使用,不是与mysql_use_result()

    偏移量应该是从0到mysql_num_rows(result)-1范围的一个值。

    20.4.6.2 返回值

    无。

    20.4.6.3 错误

    无。

     

    20.4.7 mysql_debug()

    void mysql_debug(char *debug)

    20.4.7.1 说明

    用一个给定字符串做一个DBUG_PUSHmysql_debug()使用Fred Fish 调试库。为了使用这个函数,你必须编译客户库以支持调试。见G.1 调试一个MySQL服务器和节G.2 调试一个MySQL客户

    20.4.7.2 返回值

    无。

    20.4.7.3 错误

    无。

    20.4.7.4 范例

    下面所示的调用使得客户库在客户机器上的“/tmp/client.trace”中产生一个跟踪文件:

    mysql_debug("d:t:O,/tmp/client.trace");
     

    20.4.8 mysql_drop_db()

    int mysql_drop_db(MYSQL *mysql, const char *db)

    20.4.8.1 说明

    抛弃由db参数命名的数据库。

    这个函数不推荐,而最好使用mysql_query()发出一条SQL DROP DATABASE语句。

    20.4.8.2 返回值

    如果数据库成功地被破抛弃,零。如果发生一个错误,非零。

    20.4.8.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务者的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。 

    20.4.8.4 范例

    if(mysql_drop_db(&mysql, "my_database"))
      fprintf(stderr, "Failed to drop the database: Error: %s/n",
              mysql_error(&mysql));
     

    20.4.9 mysql_dump_debug_info()

    int mysql_dump_debug_info(MYSQL *mysql)

    20.4.9.1 说明

    指示服务者将一些调试信息写入日志文件。连接的用户对此必须有precess权限才能工作。

    20.4.9.2 返回值

    如果命令成功,零。如果发生一个错误,非零。

    20.4.9.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.10 mysql_eof()

    my_bool mysql_eof(MYSQL_RES *result)

    20.4.10.1 说明

    这个函数不推荐,而使用mysql_errno()mysql_error()

    mysql_eof()确定是否已经读到了一个结果集合的最后一行。

    如果你从成功的mysql_store_result()调用获得一个结果集合,客户程序用一个操作收到全部集合。在这种情况下,从mysql_fetch_row()返回一个NULL总是意味着已经到达了结果集合的尾部,没必要调用mysql_eof()

    在另一方面,如果你使用mysql_use_result()初始化一个结果集合的检索,该集合的行随着你重复调用mysql_fetch_row()一个一个地从服务器获得。因为在这个过程中在连接上可能发生一个错误,从mysql_fetch_row()返回一个NULL值并不意味着集合正常到达了尾部。在这种情况下,你能使用mysql_eof()确定发生了什么。如果到达结果集合的尾部,mysql_eof()返回非零值,并且如果发生一个错误,返回零。

    在时间上,mysql_eof()先于标准MySQL错误函数mysql_errno()mysql_error()。因为这些错误函数提供相同的信息,他们的使用更好mysql_eof(),它现在不建议使用。(事实上,他们提供更多的信息,因为mysql_eof()值返回一个布尔值,而错误函数指出当发生错误时的出错原因。)

    20.4.10.2 返回值

    如果发生一个错误,零。如果到达结果集合的结束,非零。

    20.4.10.3 错误

    无。

    20.4.10.4 范例

    下列例子显示你必须如何使用mysql_eof()

    mysql_query(&mysql,"SELECT * FROM some_table");
    result = mysql_use_result(&mysql);
    while((row = mysql_fetch_row(result)))
    {
        // do something with data
    }
    if(!mysql_eof(result))  // mysql_fetch_row() failed due to an error
    {
        fprintf(stderr, "Error: %s/n", mysql_error(&mysql));
    }
    

    然而,你可以用标准MySQL错误函数完成同样的效果:

    mysql_query(&mysql,"SELECT * FROM some_table");
    result = mysql_use_result(&mysql);
    while((row = mysql_fetch_row(result)))
    {
        // do something with data
    }
    if(mysql_errno(&mysql))  // mysql_fetch_row() failed due to an error
    {
        fprintf(stderr, "Error: %s/n", mysql_error(&mysql));
    }
     

    20.4.11 mysql_errno()

    unsigned int mysql_errno(MYSQL *mysql)

    20.4.11.1 说明

    对于由mysql指定的连接,mysql_errno()返回最近调用的可能成功或失败的API函数的错误代码。返回值零意味着没有错误发生。客户错误消息编号列出在MySQL“errmsg.h”头文件中。服务器错误消息编号列出在“mysqld_error.h”中。

    20.4.11.2 返回值:

    一个错误代码值。如果没有错误发生,零。

    20.4.11.3 错误

    无。

    20.4.12 mysql_error()

    char *mysql_error(MYSQL *mysql)

    20.4.12.1 说明

    对于由mysql指定的连接,mysql_errno()返回最近调用的可能成功或失败的API函数的错误代码。如果没有错误发生,返回空字符串("")。这意味着下列两个测试是等价的:

    if(mysql_errno(&mysql))
    {
        // an error occurred
    }
    
    if(mysql_error(&mysql)[0] != '/0')
    {
        // an error occurred
    }
    

    客户错误消息的语言可通过重新编译MySQL客户库来改变。目前,你能在几种不同的语言间选取错误消息。见9.1 MySQL支持什么语言?

    20.4.12.2 返回值

    一个描述错误的字符串。如果没有错误发生,空字符串。

    20.4.12.3 错误

    无。

     

    20.4.13 mysql_escape_string()

    unsigned int mysql_escape_string(char *to, const char *from, unsigned int length)

    20.4.13.1 说明

    把在from中的字符串编码为在一条SQL语句中可以发给服务器的转义的SQL字符串,将结果放在to中, 并且加上一个终止的空字节。编码的字符是NUL(ASCII 0)、‘/n’、‘/r’‘/’‘'’‘"’和Control-Z(见7.1 文字:如何写字符串和数字)。

    from指向的字符串必须是length个字节长。你必须分配to的缓冲区至少length*2+1个字节长。(在更坏的情况,每个字符可能需要使用2个字节被编码,并且你需要为终止空字节的空间) 当mysql_escape_string()返回时,to的内容将是空字符终止的字符串。返回值是编码后的字符串的长度,不包括终止空字符。

    20.4.13.2 范例

    char query[1000],*end;
    
    end = strmov(query,"INSERT INTO test_table values(");
    *end++ = '/'';
    end += mysql_escape_string(end,"What's this",11);
    *end++ = '/'';
    *end++ = ',';
    *end++ = '/'';
    end += mysql_escape_string(end,"binary data: /0/r/n",16);
    *end++ = '/'';
    *end++ = ')';
    
    if (mysql_real_query(&mysql,query,(unsigned int) (end - query)))
    {
       fprintf(stderr, "Failed to insert row, Error: %s/n",
               mysql_error(&mysql));
    }
    

    例子中所用的strmov()函数被包括在mysqlclient库中且功能类似于strcpy(),但是返回一个指向空终止的第一个参数的指针。

    20.4.13.3 返回值

    放进to的值的长度,不包括终止空字符。

    20.4.13.4 错误

    无。

     

    20.4.14 mysql_fetch_field()

    MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result)

    20.4.14.1 说明

    返回作为一个MYSQL_FIELD结构的一个结果集合的一个列的定义。重复调用这个函数在结果集合中检索所有关于列的信息。当没有剩下更多的字段时,mysql_fetch_field()返回NULL

    在每次你执行一个新的SELECT查询,mysql_fetch_field()被重置(reset)以返回有关第一列的信息。由mysql_fetch_field()返回的字段也受调用mysql_field_seek()的影响。

    如果你调用mysql_query()在一张表上执行一个SELECT,但是没调用mysql_store_result(),如果你调用mysql_fetch_field()询问一个BLOB字段的长度,MySQL返回缺省BLOB长度(8K字节)。(选择8K的长度是因为MySQL不知道BLOB的最大长度。这应该在某个时候是它可配置) 一旦你已经检索了结果集合,field->max_length包含了在特定查询中对于该列最大值的长度。

    20.4.14.2 返回值

    当前列的MYSQL_FIELD结构。如果没有列剩下,NULL

    20.4.14.3 错误

    无。

    20.4.14.4 范例

    MYSQL_FIELD *field;
    
    while((field = mysql_fetch_field(result)))
    {
        printf("field name %s/n", field->name);
    }
     

    20.4.15 mysql_fetch_fields()

    MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *result)

    20.4.15.1 说明

    返回一个结果集合的所有MYSQL_FIELD结构的数组。每个结构提供结果结合中一列的字段定义。

    20.4.15.2 返回值

    一个结果集合的所有MYSQL_FIELD结构的一个数组。

    20.4.15.3 错误

    无。

    20.4.15.4 范例

    unsigned int num_fields;
    unsigned int i;
    MYSQL_FIELD *fields;
    
    num_fields = mysql_num_fields(result);
    fields = mysql_fetch_fields(result);
    for(i = 0; i < num_fields; i++)
    {
       printf("Field %u is %s/n", i, fields[i].name);
    }
    

    20.4.16 mysql_fetch_field_direct()

    MYSQL_FIELD *mysql_fetch_field_direct(MYSQL_RES *result, unsigned int fieldnr)

    20.4.16.1 说明

    给定在一个结果集合中的一个列的字段编号fieldnr,返回作为MYSQL_FIELD结构的列的字段定义。你可以使用这个函数检索任意列的义。fieldnr的值应该在从0到mysql_num_fields(result)-1范围内。

    20.4.16.2 返回值

    指定列的MYSQL_FIELD结构。

    20.4.16.3 错误

    无。

    20.4.16.4 范例

    unsigned int num_fields;
    unsigned int i;
    MYSQL_FIELD *field;
    
    num_fields = mysql_num_fields(result);
    for(i = 0; i < num_fields; i++)
    {
        field = mysql_fetch_field_direct(result, i);
        printf("Field %u is %s/n", i, field->name);
    }
     

    20.4.17 mysql_fetch_lengths()

    unsigned long *mysql_fetch_lengths(MYSQL_RES *result)

    20.4.17.1 说明

    返回在结果集合内的当前行的列长度。如果你计划拷贝字段值,这个长度信息对优化也是有用的,因为你可以避免调用strlen()。另外,如果结果集合中包含二进制数据,你必须使用这个函数确定数据的大小,因为strlen()对包含空字符的任何字段返回不正确的结果。

    空列和包含NULL的列的长度值是零。为了看清如何区分这两种情况,见mysql_fetch_row()的说明。

    20.4.17.2 返回值

    表示每列大小的无符号长整数的一个数组(不包括任何终止空字符)。如果出现一个错误,NULL

    20.4.17.3 错误

    mysql_fetch_lengths()只对结果集合的当前行有效。如果你在调用mysql_fetch_row()之前或在检索出在结果中的所有以后,它返回NULL。

    20.4.17.4 范例

    MYSQL_ROW row;
    unsigned long *lengths;
    unsigned int num_fields;
    unsigned int i;
    
    row = mysql_fetch_row(result);
    if (row)
    {
        num_fields = mysql_num_fields(result);
        lengths = mysql_fetch_lengths(result);
        for(i = 0; i < num_fields; i++)
        {
             printf("Column %u is %lu bytes in length./n", i, lengths[i]);
        }
    }
     

    20.4.18 mysql_fetch_row()

    MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

    20.4.18.1 说明

    检索一个结果集合的下一行。当在mysql_store_result()之后使用时,如果没有更多的行可见所时,mysql_fetch_row()返回NULL。当在mysql_use_result()之后使用时,当没有更多的行可检索时或如果出现一个错误,mysql_fetch_row()返回NULL。

    在行中值的数量由mysql_num_fields(result)给出。如果row保存了从一个对用mysql_fetch_row()调用返回的值,指向该值的指针作为row[0]row[mysql_num_fields(result)-1]来存取。在行中的NULL值由NULL指针指出。

    在行中字段值的长度可以通过调用mysql_fetch_lengths()获得。空字段和包含NULL的字段长度都是 0;你可以通过检查该值的指针区分他们。如果指针是NULL,字段是NULL;否则字段是空的。

    20.4.18.2 返回值

    下一行的一个MYSQL_ROW结构。如果没有更多的行可检索或如果出现一个错误,NULL。

    20.4.18.3 错误

    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.18.4 范例

    MYSQL_ROW row;
    unsigned int num_fields;
    unsigned int i;
    
    num_fields = mysql_num_fields(result);
    while ((row = mysql_fetch_row(result)))
    {
       unsigned long *lengths;
       lengths = mysql_fetch_lengths(result);
       for(i = 0; i < num_fields; i++)
       {
           printf("[%.*s] ", (int) lengths[i], row[i] ? row[i] : "NULL");
       }
       printf("/n");
    }
     

    20.4.19 mysql_field_count()

    unsigned int mysql_field_count(MYSQL *mysql)

    如果你正在使用一个比3.22.24早MySQL版本,你应该使用unsigned int mysql_num_fields(MYSQL *mysql)

    20.4.19.1 说明

    返回在连接上的最近查询的列的数量。

    这个函数一般用在mysql_store_result()返回NULL时(这样你没有结果设置指针)。在这种情况中,你能调用mysql_field_count()确定mysql_store_result()是否应该产生了一个非空的结果。这允许一个客户程序执行正确的操作,而不必知道查询是否是一条SELECT(或类SELECT)语句。下面显示的例子说明这怎样可以做到。

    20.4.51 为什么在mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    20.4.19.2 返回值

    在结果集合中表示字段数量字的一个无符号整数。

    20.4.19.3 错误

    无。

    20.4.19.4 范例

    MYSQL_RES *result;
    unsigned int num_fields;
    unsigned int num_rows;
    
    if (mysql_query(&mysql,query_string))
    {
        // error
    }
    else // query succeeded, process any data returned by it
    {
        result = mysql_store_result(&mysql);
        if (result)  // there are rows
        {
            num_fields = mysql_num_fields(result);
            // retrieve rows, then call mysql_free_result(result)
        }
        else  // mysql_store_result() returned nothing; should it have?
        {
            if(mysql_field_count(&mysql) == 0)
            {
                // query does not return data
                // (it was not a SELECT)
                num_rows = mysql_affected_rows(&mysql);
            }
            else // mysql_store_result() should have returned data
            {
                fprintf(stderr, "Error: %s/n", mysql_error(&mysql));
            }
        }
    }
    

    另一个选择是用mysql_errno(&mysql)代替mysql_field_count(&mysql)调用。在这种情况中,你直接检查来自mysql_store_result()的一个错误而非从mysql_field_count()值来推断语句是否是一个SELECT

    20.4.20 mysql_field_seek()

    MYSQL_FIELD_OFFSET mysql_field_seek(MYSQL_RES *result, MYSQL_FIELD_OFFSET offset)

    20.4.20.1 说明

    将字段光标设置到给定的偏移量。下一次调用mysql_fetch_field()将检索与该偏移量关联的列的字段定义。

    为了定位于行的起始,传递一个值为0的offset值。

    20.4.20.2 返回值

    字段光标的先前的值。

    20.4.20.3 错误

    无。

    20.4.21mysql_field_tell()

    MYSQL_FIELD_OFFSET mysql_field_tell(MYSQL_RES *result)

    20.4.21.1 说明

    返回用于最后一个mysql_fetch_field()的字段光标的位置。这个值可用作mysql_field_seek()的一个参数。

    20.4.21.2 返回值

    字段光标的当前偏移量。

    20.4.21.3 错误

    无。

    20.4.22 mysql_free_result()

    void mysql_free_result(MYSQL_RES *result)

    20.4.22.1 说明

    释放由mysql_store_result()mysql_use_result()、mysql_list_dbs()等为一个结果集合分配的内存。当你用完了一个结果集合时,你必须调用mysql_free_result()来释放它使用的内存。

    20.4.22.2 返回值

    无。

    20.4.22.3 错误

    无。

    20.4.23 mysql_get_client_info()

    char *mysql_get_client_info(void)

    20.4.23.1 说明

    返回代表客户库的版本的字符串。

    20.4.23.2 返回值

    代表MySQL客户库版本的一个字符串。

    20.4.23.3 错误

    无。

    20.4.24 mysql_get_host_info()

    char *mysql_get_host_info(MYSQL *mysql)

    20.4.24.1 说明

    返回描述正在使用的连接类型的字符串,包括服务其主机名。

    20.4.24.2 返回值

    表示服务器主机名者和连接类型的字符串。

    20.4.24.3 错误

    无。

     

    20.4.25 mysql_get_proto_info()

    unsigned int mysql_get_proto_info(MYSQL *mysql)

    20.4.25.1 说明

    返回当前连接使用的协议版本。

    20.4.25.2 返回值

    表示被当前连接使用的协议版本的一个无符号整数。

    20.4.25.3 错误

    无。

    20.4.26 mysql_get_server_info()

    char *mysql_get_server_info(MYSQL *mysql)

    20.4.26.1 说明

    返回表示服务器版本号的字符串。

    20.4.26.2 返回值

    表示服务器版本号的一个字符串。

    20.4.26.3 错误

    无。

    20.4.27 mysql_info()

    char *mysql_info(MYSQL *mysql)

    20.4.27.1 说明

    检索一个字符串,它提供有关最近执行的查询的信息,但是对下面列出的语句。对其他语句,mysql_info()返回NULL。字符串的格式随查询类型而变化,如下所述。数字仅仅是说明性的;字符串将包含对查询适当的值。

    INSERT INTO ... SELECT ...
    字符串格式: Records: 100 Duplicates: 0 Warnings: 0
    INSERT INTO ... VALUES (...),(...),(...)...
    字符串格式: Records: 3 Duplicates: 0 Warnings: 0
    LOAD DATA INFILE ...
    字符串格式: Records: 1 Deleted: 0 Skipped: 0 Warnings: 0
    ALTER TABLE
    字符串绳格式: Records: 3 Duplicates: 0 Warnings: 0
    UPDATE
    字符串格式: Rows matched: 40 Changed: 40 Warnings: 0

    注意,只有多个值在语句中指定,mysql_info()INSERT ... VALUES语句才返回非NULL值。

    20.4.27.2 返回值

    表示最近执行的查询的附加信息的一个字符串。如果得不到查询的任何信息,NULL。

    20.4.27.3 错误

    无。

    20.4.28 mysql_init()

    MYSQL *mysql_init(MYSQL *mysql)

    20.4.28.1 说明

    分配或初始化适合mysql_real_connect()的一个MYSQL对象。如果mysql是一个NULL指针,函数分配、初始化并且返回一个新对象。否则对象被初始化并且返回对象的地址。如果mysql_init()分配一个新对象,它将在调用mysql_close()关闭连接时被释放。

    20.4.28.2 返回值

    一个被初始化的MYSQL*句柄。如果没有足够的内存来分配一个新对象,NULL

    20.4.28.3 错误

    在内存不够的情况下,返回NULL

    20.4.29 mysql_insert_id()

    my_ulonglong mysql_insert_id(MYSQL *mysql)

    20.4.29.1 说明

    返回由先前的查询为一个AUTO_INCREMENT列生成的ID。在你执行一个INSERT查询向一个包含AUTO_INCREMENT字段的表中插入后,使用这个函数。

    注意,如果先前的查询不产生一个AUTO_INCREMENT值,mysql_insert_id()返回0。如果你需要在以后保存该值,必须在查询生成了该值后马上调用mysql_insert_id()

    也要注意,SQL的LAST_INSERT_ID()函数总是包含最近生成的AUTO_INCREMENT值,并且在查询之间不被重置,因为该函数的值在服务器端维护。

    20.4.29.2 返回值

    有先前的查询更新的AUTO_INCREMENT字段的值。如果在连接上没有先前的询问或如果查询没更新AUTO_INCREMENT值,返回零。

    20.4.29.3 错误

    无。

    20.4.30 mysql_kill()

    int mysql_kill(MYSQL *mysql, unsigned long pid)

    20.4.30.1 说明

    要求服务器杀死由pid指定的线程。

    20.4.30.2 返回值

    成功,零。如果出现一个错误,非零。

    20.4.30.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.31 mysql_list_dbs()

    MYSQL_RES *mysql_list_dbs(MYSQL *mysql, const char *wild)

    20.4.31.1 说明

    返回一个结果集合,它用在服务器上的匹配wild参数指定的简单正则表达式的数据库名组成。wild可以包含通配符字符“%”“_”,或可以是匹配所有的数据库的一个NULL指针。调用mysql_list_dbs()类似于执行查询SHOW databases [LIKE wild]

    你必须用mysql_free_result()释放结果集合。

    20.4.31.2 返回值

    成功,一个MYSQL_RES结果集合。如果出现一个错误,NULL。

    20.4.31.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.32 mysql_list_fields()

    MYSQL_RES *mysql_list_fields(MYSQL *mysql, const char *table, const char *wild)

    20.4.32.1 说明

    返回一个结果集合,它用在给定表中的匹配wild参数指定的简单正则表达式的列名组成。wild可以包含通配符字符“%”“_”,或可以是匹配所有列的一个NULL指针。调用mysql_list_fields()类似于执行查询SHOW COLUMNS FROM tbl_name [LIKE wild]

    注意,建议你使用SHOW COLUMNS FROM tbl_name而不是mysql_list_fields()

    你必须用mysql_free_result()释放结果集合。

    20.4.32.2 返回值

    成功,一个MYSQL_RES的结果集合。如果出线一个错误,NULL。

    20.4.32.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.33 mysql_list_processes()

    MYSQL_RES *mysql_list_processes(MYSQL *mysql)

    20.4.33.1 说明

    返回一个描述当前服务器线程的结果集合。这是与mysqladmin processlistSHOW PROCESSLIST查询报告的相同信息。

    你必须用mysql_free_result()释放结果集合。

    20.4.33.2 返回值

    成功,一个MYSQL_RES结果集合。如果发生一个错误,NULL。

    20.4.33.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务者关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.34 mysql_list_tables()

    MYSQL_RES *mysql_list_tables(MYSQL *mysql, const char *wild)

    20.4.34.1 说明

    返回一个结果集合,它用在当前数据库中的匹配wild参数指定的简单正则表达式的表名组成。wild可以包含通配符字符“%”“_”,或可以是匹配所有表的一个NULL指针。调用mysql_list_tables()类似于执行询问SHOW tables [LIKE wild]

    你必须用mysql_free_result()释放结果集合。

    20.4.34.2 返回值

    成功,一个MYSQL_RES结果集合。如果出现一个错误,NULL。

    20.4.34.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不正确的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.35 mysql_num_fields()

    unsigned int mysql_num_fields(MYSQL_RES *result)

    unsigned int mysql_num_fields(MYSQL *mysql)

    第二中形式在MySQL 3.22.24或更新版本上不能工作。为了传递一个MYSQL* 参数,你必须使用unsigned int mysql_field_count(MYSQL *mysql)

    20.4.35.1 说明

    在结果集合中返回列的数量。

    注意,你也可以通过一个指向一个结果集合或一个连接句柄的指针获得列的数量。如果mysql_store_result()mysql_user_result()返回NULL,你将使用连接句柄(而这样你没有结果集合指针)。在这种情况下,你可以调用mysql_field_count()确定mysql_store_result()是否应该产生非空的结果。这允许客户程序采取成正确的行动,不必知道查询是否是一个SELECT(或类SELECT)语句。下面被显示出的例子说明这怎么可以被做。

    20.4.51 为什么在mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    20.4.35.2 返回值

    表示一个结果集合中字段数量的一个无符号整数。

    20.4.35.3 错误

    无。

    20.4.35.4 范例

    MYSQL_RES *result;
    unsigned int num_fields;
    unsigned int num_rows;
    
    if (mysql_query(&mysql,query_string))
    {
        // error
    }
    else // query succeeded, process any data returned by it
    {
        result = mysql_store_result(&mysql);
        if (result)  // there are rows
        {
            num_fields = mysql_num_fields(result);
            // retrieve rows, then call mysql_free_result(result)
        }
        else  // mysql_store_result() returned nothing; should it have?
        {
            if (mysql_errno(&mysql))
    	{
               fprintf(stderr, "Error: %s/n", mysql_error(&mysql));
    	}
            else if (mysql_field_count(&mysql) == 0)
            {
                // query does not return data
                // (it was not a SELECT)
                num_rows = mysql_affected_rows(&mysql);
            }
        }
    }
    

    另一个选择(如果你知道你查询应该返回了一个结果结合)是用mysql_field_count(&mysql) = 0的一个检查来代替mysql_errno(&mysql)。这只会发生在出错了的情形。

    20.4.36 mysql_num_rows()

    my_ulonglong mysql_num_rows(MYSQL_RES *result)

    20.4.36.1 说明

    在结果集合中返回行的数量。

    mysql_num_rows()的使用取决于你是否使用mysql_store_result()mysql_use_result()返回一个结果集合。如果你使用mysql_store_result()mysql_num_rows()可以马上被调用。如果你使用mysql_use_result()mysql_num_rows()将不会返回正确的值,直到在结果集合中的所有行均被检索了。

    20.4.36.2 返回值

    在结果集合中行的数量。

    20.4.36.3 错误

    无。

    20.4.37 mysql_options()

    int mysql_options(MYSQL *mysql, enum mysql_option option, const char *arg)

    20.4.37.1 说明

    能用于设置额外连接选项并且影响一个连接的行为。这个函数可以被多次调用来设置多个选项。

    mysql_options()应该在mysql_init()之后和mysql_connect()mysql_real_connect()之前调用。

    option参数是你想要设置的选项;arg参数是选项的值。如果选项是一个整数,那么arg应该指向整数值。

    可能的选项值:

    选项 参数类型 功能
    MYSQL_OPT_CONNECT_TIMEOUT unsigned int * 以秒计的连接超时。
    MYSQL_OPT_COMPRESS 不使用 使用压缩的客户机/服务器协议。
    MYSQL_OPT_NAMED_PIPE 不使用 使用命名管道连接一个在NT上的MySQL服务器。
    MYSQL_INIT_COMMAND char * 当连接MySQL服务器时执行的命令。当重新连接时,将自动重新执行。
    MYSQL_READ_DEFAULT_FILE char * 从命名的选项文件而不是从“my.cnf”读取选项。
    MYSQL_READ_DEFAULT_GROUP char * “my.cnf”或用MYSQL_READ_DEFAULT_FILE指定的文件中的命名组中读取选项。

    注意,如果你使用MYSQL_READ_DEFAULT_FILEMYSQL_READ_DEFAULT_GROUP,总是读取client

    在选项文件中指定的组可能包含下列选项:

    compress 使用压缩的客户机/服务器协议。
    database 如果在连接命令中没有指定数据库,使用这个数据库。
    debug 调试选项
    host 缺省主机名
    init-command 在连接MySQL服务器时,执行的命令。当重新连接时,将自动重新执行。
    password 缺省口令
    pipe 使用命名管道连接一个在NT上的MySQL服务器。
    port 缺省端口号
    return-found-rows 告诉mysql_info()返回找到的行,而不是在使用UPDATE时,返回更新的行。
    socket 缺省套接字号
    timeout 以秒计的连接超时。
    user 缺省用户

    对于选项文件的更多信息,见4.15.4 选项文件

    20.4.37.2 返回值

    成功,零。如果你使用了未知的选项,非零。

    20.4.37.3 范例

    MYSQL mysql;
    
    mysql_init(&mysql);
    mysql_options(&mysql,MYSQL_OPT_COMPRESS,0);
    mysql_options(&mysql,MYSQL_READ_DEFAULT_GROUP,"odbc");
    if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0))
    {
        fprintf(stderr, "Failed to connect to database: Error: %s/n",
              mysql_error(&mysql));
    }
    

    上例请求客户使用压缩的客户机/服务器协议并且从my.cnf文件的odbc小节读取额外的选项。

    20.4.38 mysql_ping()

    int mysql_ping(MYSQL *mysql)

    20.4.38.1 说明

    检查到服务器的连接是否正在工作。如果它关闭了,自动尝试一个再连接。

    这个函数可被已经空闲很长时间的客户使用,来检查服务器是否关闭了连接并且如有必要重新连接。

    20.4.38.2 返回值

    如果服务器活着,零。如果出现一个错误,非零。

    20.4.38.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.39 mysql_query()

    int mysql_query(MYSQL *mysql, const char *query)

    20.4.39.1 说明

    执行指向空终止的字符串query的SQL查询,查询必须由一个单个的SQL语句组成。你不应该在语句后加上一个终止的分号(“;”)或/g

    mysql_query()不能被用于包含二进制数据的查询;相反你应该使用mysql_real_query()。(二进制数据可能包含“/0”字符,而mysql_query()将解释为查询字符串的结束。)

    20.4.39.2 返回值

    如果查询成功,零。如果出现一个错误,非零。

    20.4.39.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    到服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.40 mysql_real_connect()

    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 int client_flag)

    20.4.40.1 说明

    mysql_real_connect()试图建立到运行host的一个MySQL数据库引擎的一个连接。 mysql_real_connect()在你可以执行任何其他API函数之前必须成功地完成,除了mysql_get_client_info()

    参数指定如下:

    • 第一个参数应该是一个现存MYSQL结构的地址。在调用mysql_real_connect()之前,你必须调用mysql_init()初始化MYSQL结构。见下面的例子。
    • host值可以是一个主机名或一个IP地址。如果hostNULL或字符串"localhost",假定是到本地主机的一个连接。如果OS支持套接字(Unix)或命名管道(Win32),使用他们而不是TCP/IP与服务器连接。
    • user参数包含用户的MySQL登录ID。如果userNULL,假定是当前用户。在Unix下,它是当前登录名。在Windows ODBC下,必须明确地指定当前用户名字。见16.4 怎样填写ODBC管理程序中各种域
    • passwd参数为user包含口令。如果passwdNULL,只有在user表中对于有一个空白口令字段的用户的条目将被检查一个匹配。这允许数据库主管设置MySQL权限,使用户获得不同的口令,取决于他们是否已经指定一个口令。注意:不要试图在调用mysql_real_connect()前加密口令;口令加密自动被客户API处理。
    • db是数据库名。如果db不是NULL,连接将缺省数据库设置为这个值。
    • 如果port不是0,值对于TCP/IP连接将用作端口号。注意host参数决定连接的类型。
    • 如果unix_socket不是NULL,字符串指定套接字或应该被使用的命名管道。注意host参数决定连接的类型。
    • client_flag值通常是0,但是在很特殊的情况下可以被设置为下列标志的组合:
      标志名字 意味着的标志
      CLIENT_FOUND_ROWS 返回找到的(匹配的)行数,不是受到影响的行数。
      CLIENT_NO_SCHEMA 不允许db_name.tbl_name.col_name语法。这是为了ODBC;如果你使用该语法,导致语法分析器产生一个错误,它是为在一些ODBC程序捕捉错误是有用的。
      CLIENT_COMPRESS 使用压缩协议。
      CLIENT_ODBC 客户是一个ODBC客户。这使mysqld变得对ODBC更友好。

    20.4.40.2 返回值

    如果连接成功,一个 MYSQL*连接句柄。如果连接失败,NULL。对一个成功的连接,返回值与第一个参数值相同,除非你传递NULL给该参数。

    20.4.40.3 错误

    CR_CONN_HOST_ERROR
    不能连接MySQL服务器。
    CR_CONNECTION_ERROR
    不能连接本地MySQL服务器。
    CR_IPSOCK_ERROR
    不能创建一个IP套接字。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SOCKET_CREATE_ERROR
    不能创建一个Unix套接字。
    CR_UNKNOWN_HOST
    不能找到主机名的IP地址。
    CR_VERSION_ERROR
    由于试图使用一个不同协议版本的一个客户库与一个服务器连接导致的一个协议失配。如果你使用一个非常老的客户库连接一个没有使用--old-protocol选项启动的新服务器,这就能发生。
    CR_NAMEDPIPEOPEN_ERROR;
    不能在 Win32 上创建一个命名管道。
    CR_NAMEDPIPEWAIT_ERROR;
    不能在 Win32 上等待一个命名管道。
    CR_NAMEDPIPESETSTATE_ERROR;
    不能在 Win32 上得到一个管道处理器。

    20.4.40.4 范例

    MYSQL mysql;
    
    mysql_init(&mysql);
    if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0))
    {
        fprintf(stderr, "Failed to connect to database: Error: %s/n",
              mysql_error(&mysql));
    }
    

    20.4.41 mysql_real_query()

    int mysql_real_query(MYSQL *mysql, const char *query, unsigned int length)

    20.4.41.1 说明

    执行由query指向的SQL查询,它应该是一个length个字节的字符串。查询必须由一个单个的SQL语句组成。你不应该在语句后增加一个终止的分号(“;”)或/g

    对于包含二进制数据的查询,你必须使用mysql_real_query()而不是mysql_query(),因为二进制代码数据可能包含“/0”字符,而且,mysql_real_query()mysql_query()更快,因为它对查询字符串调用strlen()

    20.4.41.2 返回值

    如果查询成功,零。如果发生一个错误,非零。

    20.4.41.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.42 mysql_reload()

    int mysql_reload(MYSQL *mysql)

    20.4.42.1 说明

    要求MySQL服务器再次装载授权表。连接的用户必须拥有reload权限。

    不推荐这个函数。最好使用mysql_query()发出一条SQL FLUSH PRIVILEGES语句。

    20.4.42.2 返回值

    成功,零。如果发生一个错误,非零。

    20.4.42.3 错误

     
    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.43 mysql_row_seek()

    MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset)

    20.4.43.1 说明

    设置行光标为在结果集合中的任意行。这要求结果集合结构包含查询的全部结果,这样mysql_row_seek()只能与mysql_store_result()一起使用,而不与mysql_use_result()

    偏移量应该是调用mysql_row_tell()mysql_row_seek()返回的值。这个值不是简单地一个行号;如果你想要在结果集合内用行号来寻找行,使用mysql_data_seek()

    20.4.43.2 返回值

    行光标先前的值。该值可以被传递给随后的mysql_row_seek()调用。

    20.4.43.3 错误

    无。

    20.4.44 mysql_row_tell()

    MYSQL_ROW_OFFSET mysql_row_tell(MYSQL_RES *result)

    20.4.44.1 说明

    返回为了mysql_fetch_row()的行光标的当前位置。这个值可以作为一个参数用于mysql_row_seek()

    你应该仅在mysql_store_result()后使用mysql_row_tell(),而不是在mysql_use_result()后。

    20.4.44.2 返回值

    行光标当前的偏移量。

    20.4.44.3 错误

    无。

     

    20.4.45 mysql_select_db()

    int mysql_select_db(MYSQL *mysql, const char *db)

    20.4.45.1 说明

    使得由db指定的数据库成为 在由mysql指定的连接上的缺省(当前)数据库。在随后的查询中,这个数据库对于不包括一个显式的数据库指定符的表的引用是缺省数据库。

    除非连接的用户能被认证允许使用数据库,否则mysql_select_db()失败。

    20.4.45.2 返回值

    成功,零。如果发生一个错误,非零。

    20.4.45.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

     

    20.4.46 mysql_shutdown()

    int mysql_shutdown(MYSQL *mysql)

    20.4.46.1 说明

    让数据库服务器关闭。连接的用户必须有shutdown权限。

    20.4.46.2 返回值

    成功,零。如果出现一个错误,非零

    20.4.46.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。
     

    20.4.47 mysql_stat()

    char *mysql_stat(MYSQL *mysql)

    20.4.47.1 说明

    返回包含类似于由mysqladmin status命令提供的信息的一个字符串。它包括正常运行的秒数和正在运行线程、问题、再次装载和打开的表的数目。

    20.4.47.2 返回值

    描述服务器状态的一个字符串。如果出现一个错误,NULL。

    20.4.47.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.48 mysql_store_result()

    MYSQL_RES *mysql_store_result(MYSQL *mysql)

    20.4.48.1 说明

    对于成功地检索数据的每个询问(SELECTSHOWDESCRIBEEXPLAIN),你必须调用mysql_store_result()mysql_use_result()

    mysql_store_result()读取一个到客户的查询的全部结果,分配一个MYSQL_RES结构,并且把结果放进这个结构中。

    如果没有行返回,返回一个空集合集合。(空结果集合不同于一个NULL返回值。)

    一旦你调用了mysql_store_result(),你可以调用mysql_num_rows()找出结果集合中有多少行。

    你能调用mysql_fetch_row()从结果集合中取出行,或mysql_row_seek()mysql_row_tell()结果集合中获得或设置当前的行位置。

    一旦你用完结果集合,你必须调用mysql_free_result()

    20.4.51 为什么mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    20.4.48.2 返回值

    一个保存结果的MYSQL_RES结构。如果出现一个错误,NULL

    20.4.48.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.49 mysql_thread_id()

    unsigned long mysql_thread_id(MYSQL *mysql)

    20.4.49.1 说明

    返回当前连接的线程ID。这个值可用作mysql_kill()的一个参数以杀死线程。

    如果失去连接并且你用mysql_ping()重新连接,线程ID将改变。这意味着你不应该为以后使用获得线程ID并且存储它,当你需要它时,你应该获得它。

    20.4.49.2 返回值

    当前连接的线程 ID 。

    20.4.49.3 错误

    无。

    20.4.50 mysql_use_result()

    MYSQL_RES *mysql_use_result(MYSQL *mysql)

    20.4.50.1 说明

    对于成功地检索数据的每个查询(SELECTSHOWDESCRIBEEXPLAIN),你必须调用mysql_store_result()mysql_use_result()

    mysql_use_result()初始化一个结果集合的检索,但不真正将结果集合读入客户,就象mysql_store_result()那样。相反,必须通过调用mysql_fetch_row()单独检索出每一行,这直接从服务器读出结果而不在一个临时表或本地缓冲区中存储它,它比mysql_store_result()更快一点并且使用较少的内存。客户将只为当前行和一个可能最大max_allowed_packet字节的通信缓冲区分配内存。

    在另一方面,如果你在客户端对每一行正在做很多的处理,或如果输出被送到屏幕,用户可以打一个^S(停止滚动),你不应该使用mysql_use_result()。这将阻塞服务器并且阻止另外的线程从数据被取出的任何表中更新数据。

    当使用mysql_use_result()时,你必须执行mysql_fetch_row()直到返回一个NULL值,否则未取出的行将作为下一个查询的结果集合一部分被返回。如果你忘记做这个,C API将给出错误Commands out of sync; You can't run this command now

    你不能在一个从mysql_use_result()返回的结果集合上使用mysql_data_seek()mysql_row_seek()mysql_row_tell()mysql_num_rows()mysql_affected_rows(),你也不能发出另外的查询直到mysql_use_result()完成。(然而,在你取出所有的行以后,mysql_num_rows()将精确地返回取出的行数。)

    一旦你用完结果集合,你必须调用mysql_free_result()

    20.4.50.2 返回值

    一个MYSQL_RES结果结构。 如果发生一个错误发生,NULL。

    20.4.50.3 错误

    CR_COMMANDS_OUT_OF_SYNC
    命令以一个不适当的次序被执行。
    CR_OUT_OF_MEMORY
    内存溢出。
    CR_SERVER_GONE_ERROR
    MySQL服务器关闭了。
    CR_SERVER_LOST
    对服务器的连接在查询期间失去。
    CR_UNKNOWN_ERROR
    发生一个未知的错误。

    20.4.51 为什么在mysql_query()返回成功后,mysql_store_result()有时返回NULL?

    有可能在一个对mysql_query()成功的调用后,mysql_store_result()返回NULL。当这发生时,它意味着出现了下列条件之一:

    • 有一个malloc()失败(例如,如果结果集合太大)。
    • 数据不能被读取(发生在连接上的一个错误)。
    • 查询没有返回数据(例如,它是一个INSERTUPDATEDELETE)。

    你总是可以通过调用mysql_field_count()检查语句是否应该产生非空的结果。如果mysql_field_count()返回零,结果是空的并且最后一个查询是不回值的一条语句(例如,一条INSERTDELETE)。如果mysql_field_count()返回非零值,语句应该产生非空的结果。见对mysql_field_count()描述的一个例子。

    你可以调用mysql_error()mysql_errno()测试一个错误。

    20.4.52 我能从查询中得到什么结果?

    除了由查询返回的结果集合外,你也能得到下列信息:

    • 当执行一条INSERTUPDATEDELETE时,mysql_affected_rows()返回受到最后一个查询影响的行数。一个例外是如果使用一条没有WHERE子句的DELETE,表被截断,它更快!在这种情况下,mysql_affected_rows()对于影响的记录数量返回零。
    • mysql_num_rows()返回结果集合中的行数。用mysql_store_result(),一旦mysql_store_result()返回,就可以调用mysql_num_rows()。用mysql_use_result(),只有在你已经用mysql_fetch_row()取出了所有行后,才能调用mysql_num_rows()
    • mysql_insert_id()返回由将一行插入一个具有AUTO_INCREMENT索引的表中的最后查询生成的ID。见20.4.29 mysql_insert_id()
    • 某些查询(LOAD DATA INFILE ...INSERT INTO ... SELECT ...、UPDATE)返回附加的信息。结果由返mysql_info()返回。对其返回字符串的格式,见mysql_info()的描述。如果没有附加的信息,mysql_info()返回一个NULL指针。

    20.4.53 我怎样能得到最后插入的行的唯一ID?

    如果你往包含一个具有AUTO_INCREMENT属性的列的一张表中插入一个记录,你能通过mysql_insert_id()函数获得最近生成的ID。

    你也可以通过在你传递给mysql_query()的一个查询字符串中使用LAST_INSERT_ID()函数检索出ID。

    你可以执行下列代码检查是否使用一个AUTO_INCREMENT索引。这也检查查询是否是有一个AUTO_INCREMENT索引的一条INSERT:

    if (mysql_error(&mysql)[0] == 0 &&
        mysql_num_fields(result) == 0 &&
        mysql_insert_id(&mysql) != 0)
    {
        used_id = mysql_insert_id(&mysql);
    }
    

    最近产生的ID是在一个按连接的基础上在服务器上进行维护,它将不被其他客户改变。如果你更新另外一个有非奇特(non-magic)值(即一个既不是NULL也不是0的值)的AUTO_INCREMENT列,它甚至将不被改变。

    如果你想要使用为一张表生成的ID并且把它插入到第2张表,你可以使用象这样的SQL语句:

    INSERT INTO foo (auto,text)
        VALUES(NULL,'text');              # generate ID by inserting NULL
    INSERT INTO foo2 (id,text)
        VALUES(LAST_INSERT_ID(),'text');  # use ID in second table
    

    20.4.54 链接C API的问题

    当与C API链接时,下列错误可能发生一些系统上:

    gcc -g -o client test.o -L/usr/local/lib/mysql -lmysqlclient -lsocket -lnsl
    
    Undefined        first referenced
     symbol          in file
    floor            /usr/local/lib/mysql/libmysqlclient.a(password.o)
    ld: fatal: Symbol referencing errors. No output written to client
    

    如果它发生在你的系统上,你必须通过在编译/链接命令行的最后增加-lm以包括数学库。

    20.4.55 怎样制作一个线程安全的客户

    客户“几乎”是线程安全的。最大的问题是在从套接字读取的“net.c”中的子程序不是中断安全的(interruot-safe)。这样做是这样考虑的,即你可能想有你自己的报警来中断一个长时间的读取服务器。

    标准客户库没有用线程选项来编译。

    为了获得一个线程安全的客户,使用-lmysys, -lstring-ldbug库和服务器使用的net_serv.o

    当使用一个线程化的客户时,你可以充分利用在“thr_alarm.c”文件中的函数。如果你正在使用来自mysys库的函数,你唯一必须记住的是首先调用my_init()

    所有函数除了mysql_real_connect()目前是线程安全的。下列注意事项描述怎样编译一个线程安全的客户库并且以一种线程安全的方式使用它。(下面对mysql_real_connect()的注意事项实际上也适用于mysql_connect(),但是因为mysql_connect()不提倡使用,无论如何你应该使用mysql_real_connect()。)

    为了使mysql_real_connect()是线程安全的,你必须用这个命令重新编译客户库:

    shell> CPPFLAGS=-DTHREAD_SAFE_CLIENT ./configure ...
    

    当链接标准客户时,你可能得到的某些因为未定义符号的错误,因为pthread库没有被缺省地包括。

    最终的“libmysqlclient.a”库现在是线程安全的。它的含义是只要2个线程不同时查询mysql_real_connect()返回的同一个连接句柄,客户代码是线程安全的;客户机/服务器协议在一个给定的连接上一次只允许一个请求。如果你想在同一个的连接上使用多个线程,你必须在mysql_query()mysql_store_result()调用组合附近有一个mutex锁定。一旦mysql_store_result()就绪,锁可以被释放并且其他线程可以查询同一个连接。(换句话说,不同的线程能使用不同被mysql_store_result()创建的MYSQL_RES指针,只要他们使用适当的锁定协议) 如果你用POSIX线程编程,你能使用pthread_mutex_lock()pthread_mutex_unlock()建立并且释放一个mutex锁定。

    如果你使用mysql_use_result()而不是mysql_store_result(),锁定将需要包围mysql_use_result()mysql_fetch_row()的调用,然而,它确实对不使用mysql_use_result()线程客户是最好的。

    20.5 MySQL Perl API

    本节记载了Perl DBI接口。以前的接口被称为mysqlperl。因为DBI/DBD现在是推荐的Perl接口,mysqlperl是过时的并且不在这里记载。

    20.5.1 DBIDBD::mysql

    DBI是对于很多数据库的一个通用接口。这意味着你能编写一个脚本,不用改变就能工作于很多数据库引擎。你需要为每种数据库类型定义了的一个数据库驱动程序(DBD)。对于MySQL,该驱动程序称为DBD::mysql

    有关Perl5 DBI的更多信息,请访问DBI网页并且阅读文档:

    http://www.symbolstone.org/technology/perl/DBI/index.html
    

    关于在Perl5定义的面向对象的编程(OOP)的更多信息,参见Perl OOP页:

    http://language.perl.com/info/documentation.html
    

    对于MySQL Perl支持的安装指令在4.10 Perl安装说明中给出。

    20.5.2 DBI接口

    可移植的DBI方法

    connect 建立到一个数据库服务器的连接
    disconnect 断开数据库服务器的连接
    prepare 准备执行一个SQL语句
    execute 执行准备好的语句
    do 准备并执行一个SQL语句
    quote 加引号于要插入的字符串或BLOB
    fetchrow_array 作为一个字段数组取出下一行
    fetchrow_arrayref 作为一个字段的引用数组取出下一行
    fetchrow_hashref 作为一个哈希表的引用取出下一行
    fetchall_arrayref 作为一个字段数组取出所有数据
    finish 完成一条语句并且让系统释放资源
    rows 返回受影响的行数
    data_sources 返回可在localhost上得到的数据库的数组
    ChopBlanks 控制fetchrow_*方法是否剥去空格
    NUM_OF_PARAMS 在准备的语句中的占位(placeholder-参数)的数目
    NULLABLE 其列可以是NULL
    trace 执行调试跟踪

    MySQL特定的方法

    insertid 最后一个AUTO_INCREMENT
    is_blob 该列是BLOB
    is_key 该列是键
    is_num 该列是数字的
    is_pri_key 该列是主键
    is_not_null 该列不能是NULL,见NULLABLE
    length 最大可能的列大小
    max_length 结果中实际上存在的最大列大小
    NAME 列名字
    NUM_OF_FIELDS 返回的字段数目
    table 在返回的集合中的表名
    type 所有的列类型

    Perl方法在下一节更详细地描述。用于方法返回值的变量有这些含义:

    $dbh
    数据库句柄
    $sth
    语句句柄
    $rc
    返回代码 (经常是一个状态)
    $rv
    返回值 (经常是一个行数)

    可移植DBI方法

    connect($data_source, $username, $password)
    使用connect方法使得一个数据库连接到数据源。$data_source值应该以DBI:driver_name:开始。以DBD::mysql驱动程序使用connect的例子:
    $dbh = DBI->connect("DBI:mysql:$database", $user, $password);
    $dbh = DBI->connect("DBI:mysql:$database:$hostname",
                        $user, $password);
    $dbh = DBI->connect("DBI:mysql:$database:$hostname:$port",
                        $user, $password);
    

    如果用户名或口令未定义,DBI分别使用DBI_USERDBI_PASS环境变量的值。如果你不指定主机名,它缺省为'localhost'。如果你不指定一个端口号,它缺省为MySQL的缺省端口(3306)。对Msql-Mysql-modules版本1.2009,$data_source值允许某些修饰词:

    mysql_read_default_file=file_name
    读取作为一个选项文件的“filename”。有关选项文件的信息,见4.15.4 选项文件
    mysql_read_default_group=group_name
    当读取选项文件时的缺省组通常是[client]组。通过指定mysql_read_default_group选项,缺省组变成[group_name]组。
    mysql_compression=1
    在客户和服务器之间使用压缩通信(MySQL 3.22.3或以后)。
    mysql_socket=/path/to/socket
    指定用于与服务器连接的Unix套接字的路径名(MySQL 3.21.15或以后)。

    可以给出多个修饰词;每一个必须前置一个分号。例如,如果你想要避免在一个DBI脚本中硬编码用户名和口令,你可以从用户的“~/.my.cnf”选项文件中取出它们,而不是这样编写你的connect调用:

    $dbh = DBI->connect("DBI:mysql:$database"
                    . ";mysql_read_default_file=$ENV{HOME}/.my.cnf",
                    $user, $password);
    

    这个调用将读取在选项文件中为[client]组而定义的选项。如果你想做同样的事情,但是也使用未[perl]组指定的选项,你可以使用:

    $dbh = DBI->connect("DBI:mysql:$database"
                    . ";mysql_read_default_file=$ENV{HOME}/.my.cnf"
                    . ";mysql_read_default_group=perl",
                    $user, $password);
      
    disconnect
    disconnect方法从数据库断开数据库句柄。它一般就在你从程序退出之前被调用。范例:
    $rc = $dbh->disconnect;
      
    prepare($statement)
    准备一条由数据库引擎执行的SQL语句并且返回语句句柄($sth),你可以使用它调用execute方法。一般地你借助于prepareexecute来处理SELECT语句(和类SELECT语句,例如SHOWDESCRIBEEXPLAIN)。范例:
    $sth = $dbh->prepare($statement)
        or die "Can't prepare $statement: $dbh->errstr/n";
      
    execute
    execute方法执行一个准备好的语句。对非SELECT语句,execute返回受影响的行数。如果没有行受影响,execute返回"0E0",Perl将它视作零而不是真。对于SELECT语句,execute只是在数据库中启动SQL查询;你需要使用在下面描述的fetch_*方法之一检索数据。范例:
    $rv = $sth->execute
              or die "can't execute the query: $sth->errstr;
      
    do($statement)
    do方法准备并且执行一条SQL语句并且返回受影响的行数。如果没有行受到影响,do返回"0E0",Perl将它视为零而不是真。这个方法通常用于事先无法准备好(由于驱动程序的限制)或不需要执行多次(插入、删除等等)的非SELECT语句。范例:
    $rv = $dbh->do($statement)
            or die "Can't execute $statement: $dbh- >errstr/n";
        
    quote($string)
    quote方法被用来“转义”包含在string中的任何特殊字符并增加所需的外部的引号。范例:
    $sql = $dbh->quote($string)
    
    fetchrow_array
    这个方法取下一行数据并且作为一个字段值数组返回它。范例:
    while(@row = $sth->fetchrow_array) {
            print qw($row[0]/t$row[1]/t$row[2]/n);
    }
    
    fetchrow_arrayref
    这个方法取下一行数据并且作为一个对一个字段值数组的引用返回它。范例:
    while($row_ref = $sth->fetchrow_arrayref) {
            print qw($row_ref->[0]/t$row_ref->[1]/t$row_ref->[2]/n);
    }
    
    fetchrow_hashref
    这个方法取一行数据并且返回包含字段名/值对的一个哈希表的一个引用。这个方法不如使用上述数组引用那样有效。范例:
    while($hash_ref = $sth->fetchrow_hashref) {
            print qw($hash_ref->{firstname}/t$hash_ref->{lastname}/t/
                    $hash_ref- > title}/n);
    }
      
    fetchall_arrayref
    这个方法被用来获得从SQL语句被返回的所有数据(行)。它返回一个数组的引用,该数组包含对每行的数组的引用。你用一个嵌套循环来存取或打印数据。范例:
    my $table = $sth->fetchall_arrayref
                    or die "$sth->errstr/n";
    my($i, $j);
    for $i ( 0 .. $#{$table} ) {
            for $j ( 0 .. $#{$table->[$i]} ) {
                    print "$table->[$i][$j]/t";
            }
            print "/n";
    }
      
    finish
    便名没有更多的数据将从这个语句句柄取出。你调用这个方法释放语句句柄和任何与它相关的系统资源。范例:
    $rc = $sth->finish;
    
    rows
    返回由最后一条命令改变(更新、删除等)的行数。这通常用在非SELECTexecute语句之后。范例:
    $rv = $sth->rows; 
    
    NULLABLE
    返回一个对一个布尔值数组的引用;对数组的每个成员,一个TRUE值表示该列可以包含NULL值。范例:
    $null_possible = $sth->{NULLABLE};
    
    NUM_OF_FIELDS
    这个属性表明由一条SELECTSHOW FIELDS语句返回的字段数目。你可以用它检查一条语句是否返回了结果:一个零值表明一个象INSERTDELETEUPDATE的非SELECT语句。范例:
    $nr_of_fields = $sth->{NUM_OF_FIELDS};
      
    data_sources($driver_name)
    这个方法返回一个数组,它包含在主机'localhost'上的MySQL服务器可得到的数据库名。范例:
    @dbs = DBI->data_sources("mysql");
    
    ChopBlanks
    这个属性确定fetchrow_*方法是否将去掉返回值的头和尾的空白。范例:
    $sth->{'ChopBlanks'} =1;
      
    trace($trace_level)
     
    trace($trace_level, $trace_filename)
    trace方法开启或关闭跟踪。当作为一个DBI类方法调用时,它影响对所有句柄的跟踪。当作为一个数据库或语句句柄方法调用时,它影响对给定句柄的跟踪(和句柄的未来子孙)。设置$trace_level为2以提供详细的踪迹信息,设置$trace_level为0以关闭跟踪。踪迹输出缺省地输出到标准错误输出。如果指定$trace_filename,文件以添加模式打开并且所有跟踪的句柄的手被写入该文件。范例:
    DBI->trace(2);                # trace everything
    DBI->trace(2,"/tmp/dbi.out"); # trace everything to /tmp/dbi.out
    $dth->trace(2);               # trace this database handle
    $sth->trace(2);               # trace this statement handle
    

    你也可以通过设置DBI_TRACE环境变量开启DBI跟踪。将它设置为等价于调用DBI->(value)的数字值,将它设置为等价于调用DBI->(2,value)的路径名。

    MySQL特定的方法

    下面显示的方法是MySQL特定的并且不是DBI标准的部分。他们中有几个现在不建议使用:is_blobis_keyis_numis_pri_keyis_not_nulllength、max_length和table。这些已有DBI标准的另一种方法存在,他们在下面说明。

    insertid
    如果你使用MySQLAUTO_INCREMENT功能,新的自动加1的值将存储在这里。范例:
    $new_id = $sth->{insertid};
    

    作为另一种选择,你可以使用$dbh->{'mysql_insertid'}

    is_blob
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列是一个BLOB。范例:
    $keys = $sth->{is_blob};
      
    is_key
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列是键。范例:
    $keys = $sth->{is_key};
    
    is_num
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列包含数字值。范例:
    $keys = $sth->{is_key};
      
    is_pri_key
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个TRUE值表明相应的列是主键。范例:
    pri_keys = $sth->{is_pri_key}; 
      
    is_not_null
    返回一个对一个布尔值数组的引用;对数组的每个单元,一个FALSEE值表明该列可以包含NULL值。范例:
    $not_nulls = $sth->{is_not_null};
    

    is_not_null不建议使用;最好使用NULLABLE属性(在上面描述了),因为那是一个 DBI 标准。

    length
     
    max_length
    这些方法的每个返回一个对列大小数组的引用。length数组指出每列可以有的最大可能的尺寸 (如在表描述中声明的)。max_length数组指出在结果表中实际存在的最大尺寸。范例:
    $lengths = $sth->{length};
    $max_lengths = $sth->{max_length};
      
    NAME
    返回一个对一个列名数组的引用。范例:
    $names = $sth->{NAME};
    
    table
    返回一个对一个表名数组的引用。范例:
    $tables = $sth->{table};
    
    type
    返回一个对一个列类型数组的引用。范例:
    $types = $sth->{type};
    

    20.5.3 更多的DBI/DBD信息

    你可以使用perldoc命令得到更多的关于DBI的信息。

    perldoc DBI
    perldoc DBI::FAQ
    perldoc DBD::mysql
    

    你也可以使用pod2man、pod2html等工具转换到其他格式。

    而且你当然可以在DBI网页中找到最新的DBI信息:

    http://www.symbolstone.org/technology/perl/DBI/index.html
    

    20.6 MySQL Eiffel包装

    MySQL Contrib目录包含Michael Ravits编写的一个Eiffel包装程序。

    你也能在这里找到:http://www.netpedia.net/hosting/newplayer/

    20.7 MySQL Java连接(JDBC)

    有2个为MySQL支持的JDBC驱动程序(twz和mm驱动程序)。你可以在http://www.mysql.com/Contrib找到这些的一个拷贝。对于文档,请教任何JDBC文档和驱动程序本身拥有的针对MySQL特定功能的文档。

    20.8 MySQL PHP API

    PHP是一个服务器端、HTML嵌入式脚本语言,可以用来创建动态网页。它包含对存取若干数据库的支持,包括MySQL。PHP可以作为一个单独的程序运行,或编译为与Apache服务器一起使用的一个模块。

    分发和文档可在PHP网站得到。

    20.9 MySQL C++ APIs

    MySQL Contrib 目录中可得到两个API。

    20.10 MySQL Python API

    MySQL Contrib 目录包含Joseph Skinner编写的一个Python接口。

    你也可以使用对iODBC的Python接口来存取一个MySQL服务器。mxODBC

    20.11 MySQL TCL API

    TCL at binevolveContrib 目录包含一个基于msqltcl 1.50的一个TCL接口。

     
    展开全文
  • 微软正在寻找加强可以为客户提供数据分析能力的公司,他们将要收购的公司是专业从混合数据和数据仓库中提取数据的,包括本地数据和公共云数据。   微软表示收购Metanautix公司是要解决数据分析方面面临的巨大挑战...
  • c mysql api_MySQL C API

    2021-01-18 19:57:09
    如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服务器通信。这意味着,例如,你能利用很多被其他客户程序使用的同一环境变量,因为...
  • MYSQLCAPI详解.mysql api for C详细介绍(1)2009-11-22 16:33C API代码是随MySQL...如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服...
  • MYSQL_C_API详解.mysql api for C详细介绍(1)2009-11-22 16:33C API代码是随MySQL...如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQ...
  • mysql C API使用

    千次阅读 2011-11-25 17:42:05
    20 MySQL客户工具和API 20.1 MySQL C API C API代码是随MySQL...如果你正在寻找演示怎样使用C  API的例子,看一下这些客户程序。 大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服务器
  • mysql api for C详细介绍

    2013-02-20 20:53:34
    mysql api for C详细介绍 ...C API代码是随MySQL分发的,它被包含...如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。 大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服务器通信
  • MYSQL 手册【摘】

    2009-09-22 23:49:00
    20 MySQL客户工具和API20.1 MySQL C APIC API代码是随MySQL...如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL服务器通信。这意味着,例如
  • 详细的MySQL C API

    2011-02-04 14:24:00
    MySQL 代码分发中的很多客户是用 C 编写的如果你正在寻找演示怎样使用 C API 例子。 例如,大多数其他客户 API 除了 Java 所有 ) 都使用 mysqlclient 库与 MySQL 服务器通信。这意味着。能利用很多被其他客户...
  • 详细的MySQL C API [转]

    千次阅读 2004-11-05 15:22:00
    来源 http://www.leftworld.net/C API代码是随MySQL分发的,它被包含在mysqlclient库...如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。 大多数其他客户 API(除了Java的所有)都使用mysqlclient库与MySQL
  • MySQL C API

    千次阅读 2010-10-10 09:59:00
    http://www.sdau.edu.cn/support/mysq_doc/manual_Clients.html#C<br /> 20 MySQL客户工具和...如果你正在寻找演示怎样使用C API的例子,看一下这些客户程序。 大多数其他客户 API(除了Java的所有)都使用m
  • o 2.3 怎样定义和声明全局变量和函数最好? o 2.4 extern 在函数声明中是什么意思? o 2.5 关键字 auto 到底有什么用途? o 2.6 我似乎不能成功定义一个链表。我试过 typedef struct { char *item; NODEPTR next...
  • 1.7 怎样声明和定义全局变量和函数最好? 1.8 如何在C中实现不透明(抽象)数据类型? 1.9 如何生成“半全局变量”,就是那种只能被部分源文件中的部分函数访问的变量? 存储类型 1.10 同一个静态(static)函数或...
  • 《你必须知道的495个C语言问题》

    热门讨论 2010-03-20 16:41:18
    3.12 我不想学习那些复杂的规则,怎样才能避免这些未定义的求值顺序问题呢? 38 其他的表达式问题 39 *3.13 ++i和i++有什么区别? 39 3.14 如果我不使用表达式的值,那我应该用i++还是++i来做自增呢? 39 ...
  • 1.7 怎样声明和定义全局变量和函数最好? 4 1.8 如何在C中实现不透明(抽象)数据类型? 5 1.9 如何生成“半全局变量”,就是那种只能被部分源文件中的部分函数访问的变量? 5 存储类型 6 1.10 同一个静态...
  • 你必须知道的495个C语言问题(PDF)

    热门讨论 2009-09-15 10:25:47
    1.14 我总算弄清除函数指针的声明方法了, 但怎样才能初始化呢? . . 5 2 结构、联合和枚举7 2.1 声明struct x1 f . . . g; 和typedef struct f . . . g x2; 有什么不同? . 7 2.2 为什么struct x f . . . g; x ...
  • 趋势怎样工作 89 模板 90 报告 91 存档报告 92 增量报告 92 重点报告 92 作业计划程序 92 计划作业管理器 93 ARCSIGHT模式发现 94 模式发现输出: 快照和模式 94 ARCSIGHT交互式发现 95 第十章 CORR引擎 97 CORR-引擎...
  • windowsnt 技术内幕

    2014-04-09 20:47:17
    考试编号的识别 课程内容和考试内容的对照 理解微软的MCSE长远考虑 理解微软出题的方式 使用本书帮助备考 在Internet上寻找对考试有帮助的信息 寻求微软认可的课程指导 寻找高质量的和三方帮助 寻找可利用的评估软件...
  • C#微软培训资料

    2014-01-22 14:10:17
    <<page 1>> page begin==================== 目 目目 目 录 录录 录 第一部分 C#语言概述.4 第一章 第一章第一章 第一章 .NET 编 编 ... 比尔....这一天 微软公司正式推出了其下一代...
  • C#微软培训教材(高清PDF)

    千次下载 热门讨论 2009-07-30 08:51:17
    C#--微软.NET的第一语言 本书着重介绍语言本身,比较少涉及应用,不错的入门书,从头讲起,不怕不明白。 <<page 1>> page begin==================== 目 目目 目 录 ... 比尔.... 2000 年 6 月 ...
  • (5) 进化需求 客户的需要总是不断(连续)地增长,但是一般的软件开发又总是落后于客户需求的增长,如何管理需求的进化(变化)就成为软件进化的首要问题。对于传统的变化管理过程来说,其基本成分包括软件配置、软件...

空空如也

空空如也

1 2
收藏数 30
精华内容 12
关键字:

怎样寻找客户源