mysqli_data_seek

(PHP 5)

mysqli_data_seek

(no version information, might be only in CVS)

result->data_seek -- Déplace le pointeur interne de résultat

Description

Style procédural

bool mysqli_data_seek ( mysqli_result result, int offset )

Style orienté objet (méthode)

class mysqli_result {

bool data_seek ( int offset )

}

La fonction mysqli_data_seek() déplace le pointeur interne de résultat associé au jeu de résultat représenté par result, en le faisant pointer sur la ligne spécifiée par offset. Le paramètre offset doit être compris entre zéro et mysqli_num_rows() - 1 (0..mysqli_num_rows() - 1).

Note : Cette fonction ne peut être utilisée qu'avec des résultats obtenus avec la fonction mysqli_store_result() ou mysqli_query().

Valeurs de retour

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

Voir aussi

mysqli_store_result(), mysqli_fetch_row(), mysqli_fetch_array(), mysqli_fetch_assoc(), mysqli_fetch_object(), mysqli_query() et mysqli_num_rows().

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";
if (
$result = $mysqli->query( $query)) {

    
/* Déplacement du pointeur sur la ligne numéro 400 */
    
$result->data_seek(399);

    
/* Récupération de cette ligne */
    
$row = $result->fetch_row();

    
printf ("Ville : %s  Code postal: %s\n", $row[0], $row[1]);
        
    
/* Libération des résultats */
    
$result->close();
}

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

Exemple 2. Procedural style

<?php
/* Ouverture de la connexion */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* Vérification de la connexion */
if (!$link) {
    
printf("Echec de la connexion : %s\n", mysqli_connect_error());
    exit();
}

$query = "SELECT Name, CountryCode FROM City ORDER BY Name";

if (
$result = mysqli_query($link, $query)) {

    
/* Déplacement du pointeur sur la ligne numéro 400 */
    
mysqli_data_seek($result, 399);

    
/* Récupération de cette ligne */
    
$row = mysqli_fetch_row($result);

    
printf ("Ville : %s  Code postal : %s\n", $row[0], $row[1]);
        
    
/* Libération des résultats */
    
mysqli_free_result($result);
}

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

L'exemple ci-dessus va afficher :

Ville : Benin City  Code postal : NGA