MySQL 5.0 Reference Manual :: 20 Connectors and APIs :: 20.8 MySQL C API :: 20.8.3 C API Function Descriptions :: 20.8.3.26 mysql_get_character_set_info()
Section Navigation [Toggle]
- 20.8.3 C API Function Descriptions
- 20.8.3.1 mysql_affected_rows()
- 20.8.3.2 mysql_autocommit()
- 20.8.3.3 mysql_change_user()
- 20.8.3.4 mysql_character_set_name()
- 20.8.3.5 mysql_close()
- 20.8.3.6 mysql_commit()
- 20.8.3.7 mysql_connect()
- 20.8.3.8 mysql_create_db()
- 20.8.3.9 mysql_data_seek()
- 20.8.3.10 mysql_debug()
- 20.8.3.11 mysql_drop_db()
- 20.8.3.12 mysql_dump_debug_info()
- 20.8.3.13 mysql_eof()
- 20.8.3.14 mysql_errno()
- 20.8.3.15 mysql_error()
- 20.8.3.16 mysql_escape_string()
- 20.8.3.17 mysql_fetch_field()
- 20.8.3.18 mysql_fetch_field_direct()
- 20.8.3.19 mysql_fetch_fields()
- 20.8.3.20 mysql_fetch_lengths()
- 20.8.3.21 mysql_fetch_row()
- 20.8.3.22 mysql_field_count()
- 20.8.3.23 mysql_field_seek()
- 20.8.3.24 mysql_field_tell()
- 20.8.3.25 mysql_free_result()
- 20.8.3.26 mysql_get_character_set_info()
- 20.8.3.27 mysql_get_client_info()
- 20.8.3.28 mysql_get_client_version()
- 20.8.3.29 mysql_get_host_info()
- 20.8.3.30 mysql_get_proto_info()
- 20.8.3.31 mysql_get_server_info()
- 20.8.3.32 mysql_get_server_version()
- 20.8.3.33 mysql_get_ssl_cipher()
- 20.8.3.34 mysql_hex_string()
- 20.8.3.35 mysql_info()
- 20.8.3.36 mysql_init()
- 20.8.3.37 mysql_insert_id()
- 20.8.3.38 mysql_kill()
- 20.8.3.39 mysql_library_end()
- 20.8.3.40 mysql_library_init()
- 20.8.3.41 mysql_list_dbs()
- 20.8.3.42 mysql_list_fields()
- 20.8.3.43 mysql_list_processes()
- 20.8.3.44 mysql_list_tables()
- 20.8.3.45 mysql_more_results()
- 20.8.3.46 mysql_next_result()
- 20.8.3.47 mysql_num_fields()
- 20.8.3.48 mysql_num_rows()
- 20.8.3.49 mysql_options()
- 20.8.3.50 mysql_ping()
- 20.8.3.51 mysql_query()
- 20.8.3.52 mysql_real_connect()
- 20.8.3.53 mysql_real_escape_string()
- 20.8.3.54 mysql_real_query()
- 20.8.3.55 mysql_refresh()
- 20.8.3.56 mysql_reload()
- 20.8.3.57 mysql_rollback()
- 20.8.3.58 mysql_row_seek()
- 20.8.3.59 mysql_row_tell()
- 20.8.3.60 mysql_select_db()
- 20.8.3.61 mysql_set_character_set()
- 20.8.3.62 mysql_set_local_infile_default()
- 20.8.3.63 mysql_set_local_infile_handler()
- 20.8.3.64 mysql_set_server_option()
- 20.8.3.65 mysql_shutdown()
- 20.8.3.66 mysql_sqlstate()
- 20.8.3.67 mysql_ssl_set()
- 20.8.3.68 mysql_stat()
- 20.8.3.69 mysql_store_result()
- 20.8.3.70 mysql_thread_id()
- 20.8.3.71 mysql_use_result()
- 20.8.3.72 mysql_warning_count()
void mysql_get_character_set_info(MYSQL *mysql,
MY_CHARSET_INFO *cs)
Description
This function provides information about the default client
character set. The default character set may be changed with the
mysql_set_character_set()
function.
This function was added in MySQL 5.0.10.
Example
This example shows the fields that are available in the
MY_CHARSET_INFO structure:
if (!mysql_set_character_set(&mysql, "utf8"))
{
MY_CHARSET_INFO cs;
mysql_get_character_set_info(&mysql, &cs);
printf("character set information:\n");
printf("character set+collation number: %d\n", cs.number);
printf("character set name: %s\n", cs.name);
printf("collation name: %s\n", cs.csname);
printf("comment: %s\n", cs.comment);
printf("directory: %s\n", cs.dir);
printf("multi byte character min. length: %d\n", cs.mbminlen);
printf("multi byte character max. length: %d\n", cs.mbmaxlen);
}
User Comments
Some of the string members of MY_CHARSET_INFO can be NULL, particularly dir.
csname and name seem to be reversed from what the documentation and mysql.h say: In my tests, csname has the character set name and name has the collation.
Add your own comment.