文档首页
MySQL 8.4 C API 开发者指南
下载本手册
PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb


MySQL 8.4 C API 开发者指南  /  C API 基本接口  /  C API 基本函数描述

5.4 C API 基本函数描述

5.4.1 mysql_affected_rows()
5.4.2 mysql_autocommit()
5.4.3 mysql_bind_param()
5.4.4 mysql_change_user()
5.4.5 mysql_character_set_name()
5.4.6 mysql_close()
5.4.7 mysql_commit()
5.4.8 mysql_connect()
5.4.9 mysql_create_db()
5.4.10 mysql_data_seek()
5.4.11 mysql_debug()
5.4.12 mysql_drop_db()
5.4.13 mysql_dump_debug_info()
5.4.14 mysql_eof()
5.4.15 mysql_errno()
5.4.16 mysql_error()
5.4.17 mysql_escape_string()
5.4.18 mysql_fetch_field()
5.4.19 mysql_fetch_field_direct()
5.4.20 mysql_fetch_fields()
5.4.21 mysql_fetch_lengths()
5.4.22 mysql_fetch_row()
5.4.23 mysql_field_count()
5.4.24 mysql_field_seek()
5.4.25 mysql_field_tell()
5.4.26 mysql_free_result()
5.4.27 mysql_free_ssl_session_data()
5.4.28 mysql_get_character_set_info()
5.4.29 mysql_get_client_info()
5.4.30 mysql_get_client_version()
5.4.31 mysql_get_host_info()
5.4.32 mysql_get_option()
5.4.33 mysql_get_proto_info()
5.4.34 mysql_get_server_info()
5.4.35 mysql_get_server_version()
5.4.36 mysql_get_ssl_cipher()
5.4.37 mysql_get_ssl_session_data()
5.4.38 mysql_get_ssl_session_reused()
5.4.39 mysql_hex_string()
5.4.40 mysql_info()
5.4.41 mysql_init()
5.4.42 mysql_insert_id()
5.4.43 mysql_kill()
5.4.44 mysql_library_end()
5.4.45 mysql_library_init()
5.4.46 mysql_list_dbs()
5.4.47 mysql_list_fields()
5.4.48 mysql_list_processes()
5.4.49 mysql_list_tables()
5.4.50 mysql_more_results()
5.4.51 mysql_next_result()
5.4.52 mysql_num_fields()
5.4.53 mysql_num_rows()
5.4.54 mysql_options()
5.4.55 mysql_options4()
5.4.56 mysql_ping()
5.4.57 mysql_query()
5.4.58 mysql_real_connect()
5.4.59 mysql_real_connect_dns_srv()
5.4.60 mysql_real_escape_string()
5.4.61 mysql_real_escape_string_quote()
5.4.62 mysql_real_query()
5.4.63 mysql_refresh()
5.4.64 mysql_reload()
5.4.65 mysql_reset_connection()
5.4.66 mysql_reset_server_public_key()
5.4.67 mysql_result_metadata()
5.4.68 mysql_rollback()
5.4.69 mysql_row_seek()
5.4.70 mysql_row_tell()
5.4.71 mysql_select_db()
5.4.72 mysql_server_end()
5.4.73 mysql_server_init()
5.4.74 mysql_session_track_get_first()
5.4.75 mysql_session_track_get_next()
5.4.76 mysql_set_character_set()
5.4.77 mysql_set_local_infile_default()
5.4.78 mysql_set_local_infile_handler()
5.4.79 mysql_set_server_option()
5.4.80 mysql_shutdown()
5.4.81 mysql_sqlstate()
5.4.82 mysql_ssl_set()
5.4.83 mysql_stat()
5.4.84 mysql_store_result()
5.4.85 mysql_thread_id()
5.4.86 mysql_use_result()
5.4.87 mysql_warning_count()

本节介绍 C API 函数,但不包括用于预处理语句、异步接口或复制流接口的函数。有关这些函数的信息,请参见第 6.4 节,“C API 预处理语句函数描述”第 7 章,C API 异步接口第 10 章,C API 二进制日志接口

在本处的描述中,参数或返回值NULL表示 C 编程语言意义上的NULL,而不是 MySQL NULL值。

返回值的函数通常返回指针或整数。除非另有说明,否则返回指针的函数返回非NULL值表示成功,返回NULL值表示错误;返回整数的函数返回零表示成功,返回非零值表示错误。请注意,“非零”就是这个意思。除非函数描述另有说明,否则不要测试零以外的值

if (result)                   /* correct */
    ... error ...

if (result < 0)               /* incorrect */
    ... error ...

if (result == -1)             /* incorrect */
    ... error ...

当函数返回错误时,函数描述中的错误小节列出了可能出现的错误类型。您可以通过调用mysql_errno()来找出发生的错误类型。可以通过调用mysql_error()来获取错误的字符串表示形式。