(PHP 5)
mysqli_stmt_result_metadata, stmt->result_metadata() — Retourne les méta-données de préparation de requête MySQL
Style procédural
mysqli_result mysqli_stmt_result_metadata ( mysqli_stmt $stmt )Style orienté objet (méthode)
class mysqli_stmt {Si une commande a été préparée par mysqli_prepare() , et qu'elle produira un résultat, mysqli_stmt_result_metadata() retourne l'objet de résultat qui sera utilisé pour lire les méta-données, comme le nombre de champs et les informations de colonnes.
Note: Ce résultat peut être passé comme argument à toutes les fonctions qui demandent un champ, pour y lire les méta-données :
Il est recommandé de libérer la ressource de résultat lorsque vous avez terminé de l'utiliser, en la passant à la fonction mysqli_free_result() .
Note: Le jeu de résultat retourné par mysqli_stmt_result_metadata() ne contient que des méta-données. Il ne contient aucune ligne de résultat. Ces lignes sont obtenues en utilisant la fonction mysqli_stmt_fetch() .
Style procédural uniquement : Un identifiant de requête retourné par la fonction mysqli_stmt_init() .
Retourne un objet de résultats, ou FALSE si une erreur survient.
Exemple 1728. Style orienté objet
<?php
$mysqli
= new
mysqli
(
"localhost"
,
"my_user"
,
"my_password"
,
"test"
);
$mysqli
->
query
(
"DROP TABLE IF EXISTS friends"
);
$mysqli
->
query
(
"CREATE TABLE friends (id int, name varchar(20))"
);
$mysqli
->
query
(
"INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"
);
$stmt
=
$mysqli
->
prepare
(
"SELECT id, name FROM friends"
);
$stmt
->
execute
();
/* Lit les méta-données de résultat */
$result
=
$stmt
->
result_metadata
();
/* Lit les informations d'un champ, depuis les méta-données */
$field
=
$result
->
fetch_field
();
printf
(
"Nom du champ : %s\n"
,
$field
->
name
);
/* Libération du résultat */
$result
->
close
();
/* Fermeture de la connexion */
$mysqli
->
close
();
?>
Exemple 1729. Style procédural
<?php
$link
=
mysqli_connect
(
"localhost"
,
"my_user"
,
"my_password"
,
"test"
);
mysqli_query
(
$link
,
"DROP TABLE IF EXISTS friends"
);
mysqli_query
(
$link
,
"CREATE TABLE friends (id int, name varchar(20))"
);
mysqli_query
(
$link
,
"INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"
);
$stmt
=
mysqli_prepare
(
$link
,
"SELECT id, name FROM friends"
);
mysqli_stmt_execute
(
$stmt
);
/* Lit les méta-données de résultat */
$result
=
mysqli_stmt_result_metadata
(
$stmt
);
/* Lit les informations d'un champ, depuis les méta-données */
$field
=
mysqli_fetch_field
(
$result
);
printf
(
"Nom du champ : %s\n"
,
$field
->
name
);
/* Libération du résultat */
mysqli_free_result
(
$result
);
/* Fermeture de la connexion */
mysqli_close
(
$link
);
?>
| mysqli_prepare() |
| mysqli_free_result() |