Manuel PHP
Précédent |  | Suivant

# mysqli_stmt_store_result

(PHP 5)

mysqli_stmt_store_result

(no version information, might be only in CVS)

mysqli_stmt->store_result -- Récupère un jeu de résultats depuis une requête préparée

## Description

Style procédural

bool mysqli_stmt_store_result ( object stmt)

Style orienté objet (méthode)

class mysqli_stmt {
bool store_result ( void )
}

Vous devez appeler mysql_stmt_store_result() pour toutes les requêtes qui produisent un jeu de résultats (`SELECT, SHOW, DESCRIBE, EXPLAIN`), et uniquement si vous voulez stocker le jeu de résultats complet par le client, et donc, les séquences mysql_fetch() pourront retourner ces données stockées.

> Note : Ce n'est pas nécessaire d'appeler mysql_stmt_store_result() pour d'autres types de requête, mais si vous le faîtes, ce n'est pas grave et ne causera aucune perte notable de performance dans tous les cas. Vous pouvez détecter dans tous les cas si votre requête va produire un jeu de résultats en regardant si la fonction mysql_stmt_result_metadata() retourne `NULL`.

## Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès, `FALSE` en cas d'échec.

## Voir aussi

mysqli_prepare(), mysqli_stmt_result_metadata() et mysqli_fetch().

## Exemples

Exemple 1. Style orienté objet

`<?php
/* Ouverture de la connexion */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Echec de la connexion : %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = $mysqli->prepare($query)) {
/* Exécution de la requête */
$stmt->execute();
/* Stockage du résultat */
$stmt->store_result();
printf("Nombre de lignes : %d.\n", $stmt->num_rows);
/* Libération des résultats */
$stmt->free_result();
/* Fermeture du traitement */
$stmt->close();
}
/* Fermeture de la connexion */
$mysqli->close();
?>`

Exemple 2. Style procédural

`<?php
/* Ouverture de la connexion */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Echec de la connexion : %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = mysqli_prepare($link, $query)) {
/* Exécution de la requête */
mysqli_stmt_execute($stmt);
/* Stockage du résultat */
mysqli_stmt_store_result($stmt);
printf("Nombre de lignes : %d.\n", mysqli_stmt_num_rows($stmt));
/* Libération du résultat */
mysqli_stmt_free_result($stmt);
/* Fermeture du traitement */
mysqli_stmt_close($stmt);
}
/* Fermeture de la connexion */
mysqli_close($link);
?>`

L'exemple ci-dessus va afficher :

    Nombre de lignes : 20.

Précédent | Sommaire | Suivant
mysqli_stmt_sqlstate | Niveau supérieur | mysqli_store_result