Manuel PHP
PrécédentSuivant

maxdb_stmt_result_metadata

(PECL)

maxdb_stmt_result_metadata -- Retourneles méta-données du jeu de résultats pour une requête préparée

Description

Style procédural

resource maxdb_stmt_result_metadata ( resource stmt )

Style orienté objet (méthode)

class stmt {

resource result_metadata ( void )

}

Si la requête passée à maxdb_prepare() est une de celle pruisant un jeu de résultats, maxdb_stmt_result_metadata() retourne la ressource de résultats qui peut être utilisée pour récupérer les méta-données comme, le nombre total de champs et les informations individuelles d'un champs.

Note : Ce pointeur de résultats peut être passé comme argument à n'importe quelle fonction basé sur les champs qui traite les méta-données, comme :

La structure du jeu de résultats doit être libérée lorsque vous en avez terminé avec, ce qui est obtenu en la passant à la fonction maxdb_free_result().

Note : Le jeu de résultat retourné par maxdb_stmt_result_metadata() contient uniquement des méta-données. Il ne contient aucune ligne de résultats. Les lignes sont obtenues en utilisant le gestionnaire de requête avec la fonction maxdb_fetch().

Valeurs de retour

maxdb_stmt_result_metadata() retourne une ressource de résultats ou FALSE si une erreur survient.

Exemples

Exemple 1. Style orienté objet

<?php
$maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");

$maxdb->query("CREATE TABLE temp.friends (id int, name varchar(20))");

$maxdb->query("INSERT INTO temp.friends VALUES (1,'Hartmut')");
$maxdb->query("INSERT INTO temp.friends VALUES (2, 'Ulf')");

$stmt = $maxdb->prepare("SELECT id, name FROM temp.friends");
$stmt->execute();

/* Récupération du jeu de résultats pour les méta-données */
$result = $stmt->result_metadata();

/* Récupère les informations d'un champs pour les méta-données du jeu de résultats */
$field = $result->fetch_field();

printf("Nom du champs : %s\n", $field->name);

/* Fermeture du jeu de résultats */
$result->close();

/* Fermeture de la connexion */
$maxdb->close();
?>

Exemple 2. Style procédural

<?php
$link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");

maxdb_query($link, "CREATE TABLE temp.friends (id int, name varchar(20))");

maxdb_query($link, "INSERT INTO temp.friends VALUES (1,'Hartmut')");
maxdb_query($link, "INSERT INTO temp.friends VALUES (2, 'Ulf')");

$stmt = maxdb_prepare($link, "SELECT id, name FROM temp.friends");
maxdb_stmt_execute($stmt);

/* Récupération du jeu de résultats pour les méta-données */
$result = maxdb_stmt_result_metadata($stmt);

/* Récupère les informations d'un champs pour les méta-données du jeu de résultats */
$field = maxdb_fetch_field($result);

printf("Nom du champs : %s\n", $field->name);

/* Fermeture du jeu de résultats */
maxdb_free_result($result);

/* Fermeture de la connexion */
maxdb_close($link);
?>

L'exemple ci-dessus va afficher :

Nom du champs : ID

Voir aussi

maxdb_prepare() et maxdb_free_result().

PrécédentSommaireSuivant
maxdb_stmt_resetNiveau supérieurmaxdb_stmt_send_long_data

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:51