mysqli_result::data_seek

mysqli_data_seek

(PHP 5, PHP 7)

mysqli_result::data_seek -- mysqli_data_seekDéplace le pointeur interne de résultat

Description

Style orienté objet

public mysqli_result::data_seek(int $offset): bool

Style procédural

mysqli_data_seek(mysqli_result $result, int $offset): bool

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.

Liste de paramètres

result

Style procédural uniquement : Un objet mysqli_result retourné par mysqli_query(), mysqli_store_result(), mysqli_use_result(), ou mysqli_stmt_get_result().

offset

Le paramètre offset doit être compris entre zéro et mysqli_num_rows() - 1 (0..mysqli_num_rows() - 1).

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 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 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 Pays : %s\n"$row[0], $row[1]);

    
/* Libération des résultats */
    
$result->close();
}

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

Exemple #2 Style procédural

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

/* Vérification de la connexion */
if (!$link) {
    
printf("Échec 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($result399);

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

    
printf ("Ville : %s Code Pays : %s\n"$row[0], $row[1]);

    
/* Libération des résultats */
    
mysqli_free_result($result);
}

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

Les exemples ci-dessus vont afficher :

Ville : Benin City Code Pays : NGA

Notes

Note:

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

Voir aussi

add a note add a note

User Contributed Notes 1 note

up
24
kaisellgren at gmail dot com
15 years ago
This is useful function when you try to loop through the resultset numerous times.

For example:

<?php

$result
= mysqli_query($connection_id,$query);

while (
$row = mysqli_fetch_assoc($result))
{
 
// Looping through the resultset.
}

// Now if you need to loop through it again, you would first call the seek function:
mysqli_data_seek($result,0);

while (
$row = mysqli_fetch_assoc($result))
{
 
// Looping through the resultset again.
}

?>
To Top