Skip navigation links

Additional languages
17.2.3.1 mysql_affected_rows() »
Section Navigation      [Toggle]

17.2.3. C API Function Descriptions

[+/-]

17.2.3.1. mysql_affected_rows()
17.2.3.2. mysql_autocommit()
17.2.3.3. mysql_change_user()
17.2.3.4. mysql_character_set_name()
17.2.3.5. mysql_close()
17.2.3.6. mysql_commit()
17.2.3.7. mysql_connect()
17.2.3.8. mysql_create_db()
17.2.3.9. mysql_data_seek()
17.2.3.10. mysql_debug()
17.2.3.11. mysql_drop_db()
17.2.3.12. mysql_dump_debug_info()
17.2.3.13. mysql_eof()
17.2.3.14. mysql_errno()
17.2.3.15. mysql_error()
17.2.3.16. mysql_escape_string()
17.2.3.17. mysql_fetch_field()
17.2.3.18. mysql_fetch_field_direct()
17.2.3.19. mysql_fetch_fields()
17.2.3.20. mysql_fetch_lengths()
17.2.3.21. mysql_fetch_row()
17.2.3.22. mysql_field_count()
17.2.3.23. mysql_field_seek()
17.2.3.24. mysql_field_tell()
17.2.3.25. mysql_free_result()
17.2.3.26. mysql_get_client_info()
17.2.3.27. mysql_get_client_version()
17.2.3.28. mysql_get_host_info()
17.2.3.29. mysql_get_proto_info()
17.2.3.30. mysql_get_server_info()
17.2.3.31. mysql_get_server_version()
17.2.3.32. mysql_hex_string()
17.2.3.33. mysql_info()
17.2.3.34. mysql_init()
17.2.3.35. mysql_insert_id()
17.2.3.36. mysql_kill()
17.2.3.37. mysql_library_end()
17.2.3.38. mysql_library_init()
17.2.3.39. mysql_list_dbs()
17.2.3.40. mysql_list_fields()
17.2.3.41. mysql_list_processes()
17.2.3.42. mysql_list_tables()
17.2.3.43. mysql_more_results()
17.2.3.44. mysql_next_result()
17.2.3.45. mysql_num_fields()
17.2.3.46. mysql_num_rows()
17.2.3.47. mysql_options()
17.2.3.48. mysql_ping()
17.2.3.49. mysql_query()
17.2.3.50. mysql_real_connect()
17.2.3.51. mysql_real_escape_string()
17.2.3.52. mysql_real_query()
17.2.3.53. mysql_refresh()
17.2.3.54. mysql_reload()
17.2.3.55. mysql_rollback()
17.2.3.56. mysql_row_seek()
17.2.3.57. mysql_row_tell()
17.2.3.58. mysql_select_db()
17.2.3.59. mysql_set_character_set()
17.2.3.60. mysql_set_local_infile_default()
17.2.3.61. mysql_set_local_infile_handler()
17.2.3.62. mysql_set_server_option()
17.2.3.63. mysql_shutdown()
17.2.3.64. mysql_sqlstate()
17.2.3.65. mysql_ssl_set()
17.2.3.66. mysql_stat()
17.2.3.67. mysql_store_result()
17.2.3.68. mysql_thread_id()
17.2.3.69. mysql_use_result()
17.2.3.70. mysql_warning_count()

In the descriptions here, a parameter or return value of NULL means NULL in the sense of the C programming language, not a MySQL NULL value.

Functions that return a value generally return a pointer or an integer. Unless specified otherwise, functions returning a pointer return a non-NULL value to indicate success or a NULL value to indicate an error, and functions returning an integer return zero to indicate success or non-zero to indicate an error. Note that “non-zero” means just that. Unless the function description says otherwise, do not test against a value other than zero: 

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

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

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

When a function returns an error, the Errors subsection of the function description lists the possible types of errors. You can find out which of these occurred by calling mysql_errno(). A string representation of the error may be obtained by calling mysql_error().

MySQL Enterprise.  MySQL Enterprise subscribers will find more information about the C API functions in the Knowledge Base articles, The C API. Access to the MySQL Knowledge Base collection of articles is one of the advantages of subscribing to MySQL Enterprise. For more information, see http://www.mysql.com/products/enterprise/advisors.html.