- 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_use_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).
mysql_use_result() initialise un jeu de
résultats mais ne l'enregistre pas dans le client comme le
fait mysql_store_result(). A la place,
chaque ligne doit être récupéré manuellement à l'aide de
la commande mysql_fetch_row(). Cela lit le
résultat directement à partir du serveur sans l'enregistrer
dans une table temporaire ou un tampon local, ce qui est plus
rapide et utilise moins de mémoire que
mysql_store_result(). Le client n'allouera
de la mémoire que pour la ligne courante et un tampon de
communication qui peut aller jusqu'à
max_allowed_packet octets.
D'une autre côté, vous ne devez pas utiliser
mysql_use_result() si vous faites beaucoup
de traitements pour chaque ligne côté client, ou que le
résultat est envoyé à un écran où l'utilisateur peut
entrer ^S (arrêt défilement). Cela
bloquera le serveur et empêchera les autres threads de mettre
à jour n'importe quelle table à partir de laquelle les
données sont lues.
Lors de l'utilisation de
mysql_use_result(), vous devez exécuter
mysql_fetch_row() jusqu'à ce que
NULL soit retourné, sinon, les lignes non
retournée seront inclues dans le jeu de résultat de votre
prochaine requête. L'API C donnera l'erreur Commands
out of sync; you can't run this command now si vous
oubliez de le faire !
Vous ne devez pas utiliser
mysql_data_seek(),
mysql_row_seek(),
mysql_row_tell(),
mysql_num_rows(), ou
mysql_affected_rows() avec un résultat
retourné par mysql_use_result(), de même,
vous ne devez pas exécuter d'autres requêtes tant que la
commande mysql_use_result() n'est pas
terminée. (Toutefois, après avoir récupéré toutes les
lignes, mysql_num_rows() retournera
correctement le nombre de lignes récupérées.)
Vous devez appeler mysql_free_result()
lorsque vous n'avez plus besoin du jeu de résultats.
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.
