- 20.9.3 C API Function Descriptions
- 20.9.3.1 mysql_affected_rows()
- 20.9.3.2 mysql_autocommit()
- 20.9.3.3 mysql_change_user()
- 20.9.3.4 mysql_character_set_name()
- 20.9.3.5 mysql_close()
- 20.9.3.6 mysql_commit()
- 20.9.3.7 mysql_connect()
- 20.9.3.8 mysql_create_db()
- 20.9.3.9 mysql_data_seek()
- 20.9.3.10 mysql_debug()
- 20.9.3.11 mysql_drop_db()
- 20.9.3.12 mysql_dump_debug_info()
- 20.9.3.13 mysql_eof()
- 20.9.3.14 mysql_errno()
- 20.9.3.15 mysql_error()
- 20.9.3.16 mysql_escape_string()
- 20.9.3.17 mysql_fetch_field()
- 20.9.3.18 mysql_fetch_field_direct()
- 20.9.3.19 mysql_fetch_fields()
- 20.9.3.20 mysql_fetch_lengths()
- 20.9.3.21 mysql_fetch_row()
- 20.9.3.22 mysql_field_count()
- 20.9.3.23 mysql_field_seek()
- 20.9.3.24 mysql_field_tell()
- 20.9.3.25 mysql_free_result()
- 20.9.3.26 mysql_get_character_set_info()
- 20.9.3.27 mysql_get_client_info()
- 20.9.3.28 mysql_get_client_version()
- 20.9.3.29 mysql_get_host_info()
- 20.9.3.30 mysql_get_proto_info()
- 20.9.3.31 mysql_get_server_info()
- 20.9.3.32 mysql_get_server_version()
- 20.9.3.33 mysql_get_ssl_cipher()
- 20.9.3.34 mysql_hex_string()
- 20.9.3.35 mysql_info()
- 20.9.3.36 mysql_init()
- 20.9.3.37 mysql_insert_id()
- 20.9.3.38 mysql_kill()
- 20.9.3.39 mysql_library_end()
- 20.9.3.40 mysql_library_init()
- 20.9.3.41 mysql_list_dbs()
- 20.9.3.42 mysql_list_fields()
- 20.9.3.43 mysql_list_processes()
- 20.9.3.44 mysql_list_tables()
- 20.9.3.45 mysql_more_results()
- 20.9.3.46 mysql_next_result()
- 20.9.3.47 mysql_num_fields()
- 20.9.3.48 mysql_num_rows()
- 20.9.3.49 mysql_options()
- 20.9.3.50 mysql_ping()
- 20.9.3.51 mysql_query()
- 20.9.3.52 mysql_real_connect()
- 20.9.3.53 mysql_real_escape_string()
- 20.9.3.54 mysql_real_query()
- 20.9.3.55 mysql_refresh()
- 20.9.3.56 mysql_reload()
- 20.9.3.57 mysql_rollback()
- 20.9.3.58 mysql_row_seek()
- 20.9.3.59 mysql_row_tell()
- 20.9.3.60 mysql_select_db()
- 20.9.3.61 mysql_set_character_set()
- 20.9.3.62 mysql_set_local_infile_default()
- 20.9.3.63 mysql_set_local_infile_handler()
- 20.9.3.64 mysql_set_server_option()
- 20.9.3.65 mysql_shutdown()
- 20.9.3.66 mysql_sqlstate()
- 20.9.3.67 mysql_ssl_set()
- 20.9.3.68 mysql_stat()
- 20.9.3.69 mysql_store_result()
- 20.9.3.70 mysql_thread_id()
- 20.9.3.71 mysql_use_result()
- 20.9.3.72 mysql_warning_count()
int mysql_set_server_option(MYSQL *mysql, enum
enum_mysql_set_option option)
Description
Enables or disables an option for the connection.
option can have one of the following values.
MYSQL_OPTION_MULTI_STATEMENTS_ON |
Enable multiple-statement support |
MYSQL_OPTION_MULTI_STATEMENTS_OFF |
Disable multiple-statement support |
If you enable multiple-statement support, you should retrieve
results from calls to
mysql_query() or
mysql_real_query() by using a
loop that calls
mysql_next_result() to determine
whether there are more results. For an example, see
Section 20.9.12, “C API Support for Multiple Statement Execution”.
Enabling multiple-statement support with
MYSQL_OPTION_MULTI_STATEMENTS_ON does not
have quite the same effect as enabling it by passing the
CLIENT_MULTI_STATEMENTS flag to
mysql_real_connect():
CLIENT_MULTI_STATEMENTS also enables
CLIENT_MULTI_RESULTS. If you are using the
CALL SQL statement in your
programs, multiple-result support must be enabled; this means
that MYSQL_OPTION_MULTI_STATEMENTS_ON by
itself is insufficient to allow the use of
CALL.
Return Values
Zero for success. Nonzero if an error occurred.
Errors
-
Commands were executed in an improper order.
-
The MySQL server has gone away.
-
The connection to the server was lost during the query.
-
The server didn't support
mysql_set_server_option()(which is the case that the server is older than 4.1.1) or the server didn't support the option one tried to set.
User Comments
This does not do the same thing as setting CLIENT_MULTI_STATEMENTS in the call to mysql_real_connect. When you pass CLIENT_MULTI_STATEMENTS at connection time it also sets the CLIENT_MULTI_RESULTS flag. You don't appear to have control over multiple result sets when using mysql_set_server_option.
Add your own comment.