mysqli_use_result,

(PHP 5)

mysqli_use_result, mysqli->use_result() — Initialise la récupération d'un jeu de résultats

Description

Style procédural

mysqli_result mysqli_use_result ( mysqli $link )

Style orienté objet (méthode)

class mysqli {
mysqli_result use_result ( void )
}

Utilisé pour initialiser la récupération d'un jeu de résultats à partir de la dernière requête exécutée en utilisant la fonction mysqli_real_query() sur la connexion spécifiée par le paramètre link .

Cette fonction ou la fonction mysqli_store_result() doivent être appelées avant que le résultat d'une requête ne puisse être récupéré, et pour éviter l'échec de la prochaine requête sur la connexion à la base de données.

Note: La fonction mysqli_use_result() ne transfère pas le jeu de résultats en entier à partir de la base de données et on ne peut donc pas utiliser des fonctions telle mysqli_data_seek() pour se déplacer entre les enregistrements. Pour utiliser cette fonctionnalité, vous devez récupérer le jeu de résultats en utilisant mysqli_store_result() .

Valeurs de retour

Retourne un objet de résultats non stockés ou FALSE si une erreur survient.

Exemples

Exemple 1737. Style orienté objet

<?php
$mysqli 
= new  mysqli ( "localhost" "my_user" "my_password" "world" );

/* Vérification de la connexion */
if ( mysqli_connect_errno ()) {
    
printf ( "Échec de la connexion : %s\n" mysqli_connect_error ());
    exit();
}

$query   "SELECT CURRENT_USER();" ;
$query  .=  "SELECT Name FROM City ORDER BY ID LIMIT 20, 5" ;

/* Exécution de plusieurs requêtes */
if ( $mysqli -> multi_query ( $query )) {
    do {
        
/* Stockage du premier jeu de résultats */
        
if ( $result  $mysqli -> use_result ()) {
            while (
$row  $result -> fetch_row ()) {
                
printf ( "%s\n" $row [ 0 ]);
            }
            
$result -> close ();
        }
        
/* Affichage d'une démarquation */
        
if ( $mysqli -> more_results ()) {
            
printf ( "-----------------\n" );
        }
    } while (
$mysqli -> next_result ());
}

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

Exemple 1738. Style procédural

<?php
$link 
mysqli_connect ( "localhost" "my_user" "my_password" "world" );

/* Vérification de la connexion */
if ( mysqli_connect_errno ()) {
    
printf ( "Échec de la connexion : %s\n" mysqli_connect_error ());
    exit();
}

$query   "SELECT CURRENT_USER();" ;
$query  .=  "SELECT Name FROM City ORDER BY ID LIMIT 20, 5" ;

/* Exécution de plusieurs requêtes */
if ( mysqli_multi_query ( $link $query )) {
    do {
        
/* Stockage du premier jeu de résultats */
        
if ( $result  mysqli_use_result ( $link )) {
            while (
$row  mysqli_fetch_row ( $result )) {
                
printf ( "%s\n" $row [ 0 ]);
            }
            
mysqli_free_result ( $result );
        }
        
/* Affichage d'une démarquation */
        
if ( mysqli_more_results ( $link )) {
            
printf ( "-----------------\n" );
        }
    } while (
mysqli_next_result ( $link ));
}

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

L'exemple ci-dessus va afficher :


my_user@localhost
-----------------
Amersfoort
Maastricht
Dordrecht
Leiden
Haarlemmermeer

  

Voir aussi

mysqli_real_query()
mysqli_store_result()