- Documentation Library
- Table of Contents
- MySQL 5.0 Manual
- Table of Contents
- 24.2.3 Description des fonctions de l'API C
- 24.2.3.1 mysql_affected_rows()
- 24.2.3.2 mysql_change_user()
- 24.2.3.3 mysql_character_set_name()
- 24.2.3.4 mysql_close()
- 24.2.3.5 mysql_connect()
- 24.2.3.6 mysql_create_db()
- 24.2.3.7 mysql_data_seek()
- 24.2.3.8 mysql_debug()
- 24.2.3.9 mysql_drop_db()
- 24.2.3.10 mysql_dump_debug_info()
- 24.2.3.11 mysql_eof()
- 24.2.3.12 mysql_errno()
- 24.2.3.13 mysql_error()
- 24.2.3.14 mysql_escape_string()
- 24.2.3.15 mysql_fetch_field()
- 24.2.3.16 mysql_fetch_fields()
- 24.2.3.17 mysql_fetch_field_direct()
- 24.2.3.18 mysql_fetch_lengths()
- 24.2.3.19 mysql_fetch_row()
- 24.2.3.20 mysql_field_count()
- 24.2.3.21 mysql_field_seek()
- 24.2.3.22 mysql_field_tell()
- 24.2.3.23 mysql_free_result()
- 24.2.3.24 mysql_get_client_info()
- 24.2.3.25 mysql_get_client_version()
- 24.2.3.26 mysql_get_host_info()
- 24.2.3.27 mysql_get_proto_info()
- 24.2.3.28 mysql_get_server_info()
- 24.2.3.29 mysql_get_server_version()
- 24.2.3.30 mysql_hex_string()
- 24.2.3.31 mysql_info()
- 24.2.3.32 mysql_init()
- 24.2.3.33 mysql_insert_id()
- 24.2.3.34 mysql_kill()
- 24.2.3.35 mysql_library_end()
- 24.2.3.36 mysql_library_end()
- 24.2.3.37 mysql_list_dbs()
- 24.2.3.38 mysql_list_fields()
- 24.2.3.39 mysql_list_processes()
- 24.2.3.40 mysql_list_tables()
- 24.2.3.41 mysql_num_fields()
- 24.2.3.42 mysql_num_rows()
- 24.2.3.43 mysql_options()
- 24.2.3.44 mysql_ping()
- 24.2.3.45 mysql_query()
- 24.2.3.46 mysql_real_connect()
- 24.2.3.47 mysql_real_escape_string()
- 24.2.3.48 mysql_real_query()
- 24.2.3.49 mysql_reload()
- 24.2.3.50 mysql_row_seek()
- 24.2.3.51 mysql_row_tell()
- 24.2.3.52 mysql_select_db()
- 24.2.3.53 mysql_set_server_option()
- 24.2.3.54 mysql_shutdown()
- 24.2.3.55 mysql_sqlstate()
- 24.2.3.56 mysql_ssl_set()
- 24.2.3.57 mysql_stat()
- 24.2.3.58 mysql_store_result()
- 24.2.3.59 mysql_thread_id()
- 24.2.3.60 mysql_use_result()
- 24.2.3.61 mysql_warning_count()
- 24.2.3.62 mysql_commit()
- 24.2.3.63 mysql_rollback()
- 24.2.3.64 mysql_autocommit()
- 24.2.3.65 mysql_more_results()
- 24.2.3.66 mysql_next_result()
unsigned long mysql_hex_string(char *to, const char
*from, unsigned long length)
Description
Cette fonction sert à créer une chaîne SQL valide que vous pouvez utiliser dans une requête SQL. See Section 9.1.1, « Chaînes ».
La chaîne de l'argument from est encodée
au format hexadécimal, et chaque caractère prend alors deux
chiffres hexadécimaux. Le résultat est placé dans le
paramètre to et un caractère nul termine
la chaîne.
La chaîne pointée par from doit faire
length octets de long. Vous devez allouer
le buffer to à au moins longueur
* 2 + 1 de long. Lorsque
mysql_hex_string() se termine, le contenu
de to est une chaîne terminée par un
caractère nul. La valeur de retour est la taille de la
chaîne encodée, sans compter le caractère nul.
La valeur retournée peut être placée dans une commande SQL
en utilisant le format
0x ou
valueX'.
Cependant, la valeur de retour n'inclut pas les éléments de
syntaxe value'0x ou X'...'. Le
code appelant doit fournir les éléments dont il a besoin.
mysql_hex_string() a été ajouté en MySQL
4.0.23 et 4.1.8.
Exemple
char query[1000],*end;
end = strmov(query,"INSERT INTO test_table values(");
end = strmov(end,"0x");
end += mysql_hex_string(end,"What's this",11);
end = strmov(end,",0x");
end += mysql_hex_string(end,"binary data: \0\r\n",16);
*end++ = ')';
if (mysql_real_query(&mysql,query,(unsigned int) (end - query)))
{
fprintf(stderr, "Failed to insert row, Error: %s\n",
mysql_error(&mysql));
}
La fonction strmov() utilisée dans
l'exemple est incluse dans la bibliothèque cliente
mysqlclient et fonctionne comme
strcpy() mais retourne un pointeur sur le
caractère nul final du premier paramètre.
Valeur retournée
La taille de la valeur placée dans to,
hormis le caractère nul final.
Erreurs
Aucune.
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.
