Documentation PHP

mysqli_stmt::result_metadata

mysqli_stmt_result_metadata

(PHP 5)

mysqli_stmt_result_metadata — Retourne les mŽtadonnŽes de prŽparation de requte MySQL

Description

Style orientŽ objet (mŽthode) :

mysqli_result mysqli_stmt::result_metadata ( void )

Style procŽdural :

mysqli_result mysqli_stmt_result_metadata ( mysqli_stmt $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ŽtadonnŽ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ŽtadonnŽ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ŽtadonnŽes. Il ne contient aucune ligne de rŽsultat. Ces lignes sont obtenues en utilisant la fonction mysqli_stmt_fetch().

Liste de paramètres

stmt

Style procédural uniquement : Un identifiant de requête retourné par la fonction mysqli_stmt_init().

Valeurs de retour

Retourne un objet de rŽsultats, ou FALSE si une erreur survient.

Exemples

Exemple #1 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 #2 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);
?>



Ceci n'est pas la documentation originale du langage de programmation php, pour y accéder visiter le site www.php.net

Support du web, outils, services, compteurs, scripts, générateurs et autres outils pour les webmasters gratuitement à 100%
Page générée en 0.002158 secondes.