- Documentation Library
- Table of Contents
- MySQL 5.0 Manual
- Table of Contents
- 24.2.7 Description des fonctions C pour les requêtes préparées
- 24.2.7.1 mysql_stmt_affected_rows()
- 24.2.7.2 mysql_stmt_attr_get()
- 24.2.7.3 mysql_stmt_attr_set()
- 24.2.7.4 mysql_stmt_bind_param()
- 24.2.7.5 mysql_stmt_bind_result()
- 24.2.7.6 mysql_stmt_close()
- 24.2.7.7 mysql_stmt_data_seek()
- 24.2.7.8 mysql_stmt_errno()
- 24.2.7.9 mysql_stmt_error()
- 24.2.7.10 mysql_stmt_execute()
- 24.2.7.11 mysql_stmt_free_result()
- 24.2.7.12 mysql_stmt_insert_id()
- 24.2.7.13 mysql_stmt_fetch()
- 24.2.7.14 mysql_stmt_fetch_column()
- 24.2.7.15 mysql_stmt_field_count()
- 24.2.7.16 mysql_stmt_init()
- 24.2.7.17 mysql_stmt_num_rows()
- 24.2.7.18 mysql_stmt_param_count()
- 24.2.7.19 mysql_stmt_param_metadata()
- 24.2.7.20 mysql_stmt_prepare()
- 24.2.7.21 mysql_stmt_reset()
- 24.2.7.22 mysql_stmt_result_metadata()
- 24.2.7.23 mysql_stmt_row_seek()
- 24.2.7.24 mysql_stmt_row_tell()
- 24.2.7.25 mysql_stmt_send_long_data()
- 24.2.7.26 mysql_stmt_sqlstate()
- 24.2.7.27 mysql_stmt_store_result()
int mysql_stmt_store_result(MYSQL_STMT
*stmt)
Description
Vous devez appeler la fonction
mysql_stmt_store_result() pour chaque
requête qui doit lire de données (SELECT,
SHOW, DESCRIBE,
EXPLAIN) et uniquement si vous voulez lire
la totalité du résultat dans un buffer du client, pour que
les appels suivants à mysql_fetch()
retourne des données bufferisées.
Vous n'avez pas à appeler
mysql_stmt_store_result() pour les
requêtes suivantes, mais cela ne causera pas de
ralentissement notable. Vous pouvez détecter si une requête
n'a pas de résultat en vérifiant si
mysql_prepare_result() retourne 0. Pour
plus d'informations, voyez
Section 24.2.7.22, « mysql_stmt_result_metadata() ».
Note : MySQL ne calcule pas
par défaut MYSQL_FIELD->max_length pour
toutes les colonnes de
mysql_stmt_store_result() car ce calcul
ralentirait considérablement
mysql_stmt_store_result() et la plupart des
applications n'ont pas besoin de
max_length. Si vous voulez
max_length, vous pouvez appeler
mysql_stmt_attr_set(MYSQL_STMT,
STMT_ATTR_UPDATE_MAX_LENGTH, &flag) pour
l'obtenir. See Section 24.2.7.3, « mysql_stmt_attr_set() ».
Valeurs retournées
Zéro si les résultats sont mis en buffer
correctement, et non-nul si une erreur survient.
Errors
-
CR_COMMANDS_OUT_OF_SYNCCommands were executed in an improper order : les commandes ont été exécutées dans un ordre invalide.
-
CR_OUT_OF_MEMORYOut of memory : plus de mémoire.
-
CR_SERVER_GONE_ERRORThe MySQL server has gone away : le serveur MySQL s'est éteind.
-
CR_SERVER_LOSTThe connection to the server was lost during the query : la connexion au serveur MySQL s'est interrompue durant la commande.
-
CR_UNKNOWN_ERRORAn unknown error occurred : une erreur inconnue est survenue.
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.
