- 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()
MYSQL_RES *mysql_store_result(MYSQL *mysql)
Description
Vous devez appeler mysql_store_result() ou
mysql_use_result() pour chaque requête qui
récupère des données avec succès
(SELECT, SHOW,
DESCRIBE, EXPLAIN).
Vous n'avez pas à appeler
mysql_store_result() ou
mysql_use_result() pour d'autres requêtes,
mais cela ne posera pas de problèmes ou ne ralentira pas vos
scripts si vous appelez
mysql_store_result() en tout cas. Vous
pouvez savoir si la requête n'a pas renvoyé de résultat en
vérifiant si mysql_store_result() retourne
0 (nous verrons cela plus tard).
Si vous voulez savoir si la requête devrait renvoyer un jeu
de résultats ou non, vous pouvez utiliser
mysql_field_count() pour vérifier. See
Section 24.2.3.20, « mysql_field_count() ».
mysql_store_result() lit le résultat en
entier et le stocke dans le client, alloue une structure
MYSQL_RES, et place le résultat dans cette
structure.
mysql_store_result() retourne un pointeur
nul si la requête n'a pas retourné un jeu de résultats (si
la requête était, par exemple, un
INSERT).
mysql_store_result() retourne aussi un
pointeur nul si la lecture à partir du jeu de résultats
échoue. Vous pouvez vérifier la présence d'erreurs en
regardant si mysql_error() ne retourne pas
de pointeur nul, si mysql_errno() retourne
<> 0, ou si mysql_field_count()
retourne <> 0.
Un jeu de résultat vide est retourné si aucune ligne n'est retournée. (Un jeu de résultats vide diffère d'un pointeur nul en tant que valeur de retour.)
Une fois que vous avez appelé
mysql_store_result() et obtenu un résultat
qui n'est pas un pointeur nul, vous devez appeler
mysql_num_rows() pour trouver combien de
lignes contient le jeu de résultats.
Vous pouvez appeler mysql_fetch_row() pour
récupèrer des lignes à partir du jeu de résultats, ou
mysql_row_seek() et
mysql_row_tell() pour obtenir ou changer la
ligne courante dans le jeu de résultats.
Vous devez appeler mysql_free_result() une
fois que vous n'avez plus besoin du résultat.
Valeur de retour
Une structure de résultat MYSQL_RES.
NULL si une erreur survient.
Erreurs
-
CR_COMMANDS_OUT_OF_SYNCLes commandes n'ont pas été exécutées dans le bon ordre.
-
CR_OUT_OF_MEMORYPlus de mémoire.
-
CR_SERVER_GONE_ERRORLe serveur MySQL ne réponds pas.
-
CR_SERVER_LOSTLa connexion au serveur a été perdue au cours la requête.
-
CR_UNKNOWN_ERRORUne erreur inconnue s'est produite.
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.
