MYSQL_RES *mysql_stmt_result_metadata(MYSQL_STMT
*stmt)
Description
Si la fonction mysql_prepare()
a généré
un résultat, alors
mysql_stmt_result_metadata()
retourne les
méta données de résultats sous la forme d'un structure
MYSQL_RES
, qui peut être utilisée
ultérieurement pour traiter des méta informations, telles qu
le nombre de champs et les informations individuelles de
champs. Ce résultat peut être passé en argument à l'une
des fonctions de champs suivantes, pour traiter les
données :
mysql_num_fields()
mysql_fetch_field()
mysql_fetch_field_direct()
mysql_fetch_fields()
mysql_field_count()
mysql_field_seek()
mysql_field_tell()
mysql_free_result()
La structure de jeu de résultats doit être libérée une
fois que vous en ave fini avec, grâce à la fonction
mysql_free_result()
. C'est similaire à la
méthode pour libérer les ressources obtenus de
mysql_store_result()
.
Le jeu de résultats retourné par
mysql_stmt_result_metadata()
contient
uniquement des méta-données. Il ne contient aucune ligne de
résultat. Les lignes sont lues en utitilisant la ressource de
commande, avec la fonction
mysql_stmt_fetch()
.
Valeurs retournées
Une structure de type MYSQL_RES
. NULL si
aucune méta données n'existe pour la requête préparée.
Erreurs
CR_OUT_OF_MEMORY
Out of memory : plus de mémoire
CR_UNKNOWN_ERROR
An unknown error occured : Une erreur inconnue est survenue.
Exemple
Pour une illustration de la fonction
mysql_stmt_result_metadata()
, voyez
l'exemple de la fonction Section 24.2.7.13, « mysql_stmt_fetch()
».
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.