- 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_prepare(MYSQL_STMT *stmt, const char
*query, unsigned long length)
Description
Prépare la requête représentée par la chaîne terminée
par NUL query, et retourne un pointeur de
commande à utiliser ultérieurement pour les autres
opérations. La requête doit contenir une commande SQL
unique. Vous ne devez pas ajouter le point-virgule
(‘;’) ni \g
de fin de requête.
L'application peut inclure une ou plusieurs variable de
requête SQL, grâce au caractère point d'interrogation
(‘?’), placé dans la commande
SQL, aux bons endroits.
Les variables de requêtes ne sont valides qu'à certaines
places dans les commandes SQL. Par exemple, elles sont
autorisées dans les listes VALUES() d'une
commande INSERT (pour spécifier les
valeurs des lignes), ou dans les clauses de comparaisons
WHERE, pour spécifier une valeur de
comparaison. Sinon, elles ne sont pas autorisées pour les
identifiants (comme les noms de tables ou de colonnes), dans
les listes de colonnes sélectionnées par la commande
SELECT, ou pour spécifier un opérateur
tel que =. Cette dernière restriction est
due au fait qu'il serait impossible de déterminer le type de
paramètre. En général, les variables ne sont autorisées
que dans les commandes de manipulations de données
(Data Manipulation Language (DML)), et non
pas dans les commandes de définition des données
(Data Defination Language (DDL).
Les variables de requêtes doivent être liés par
l'application à des variables, avec la fonction
mysql_stmt_bind_param() avant exécution.
Valeur retournées
Erreurs
-
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 s'est éteint durant l'exécution de la requête. -
CR_SERVER_LOSTThe connection to the server was lost during the query: la connexion au serveur a été perdue. -
CR_UNKNOWN_ERRORAn unknown error occurred: erreur inconnue.
Si la préparation échoue, c'est à dire si
mysql_stmt_prepare() retourne
NULL), un message d'erreur peut être
obtenu en appelant mysql_error().
Exemple
Pour une utilisation de
mysql_stmt_prepare(), voyez l'exemple dans
Section 24.2.7.10, « mysql_stmt_execute() ».
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.
