Ajuste le pointeur de résultat vers une ligne arbitraire dans le résultat mis en mémoire tampon.

# mysqli_stmt::data_seek

# mysqli_stmt_data_seek

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::data_seek -- mysqli_stmt_data_seek — Ajuste le pointeur de résultat vers une ligne arbitraire dans le résultat mis en mémoire tampon.

### Description

Style orienté objet

public function mysqli_stmt::data_seek(int `$offset`): void

Style procédural

function mysqli_stmt_data_seek(mysqli_stmt `$statement`, int `$offset`): void

Cette fonction déplace le pointeur du jeu de résultats mis en mémoire tampon vers une ligne arbitraire spécifiée par le paramètre `offset`.

Cette fonction ne fonctionne que sur le jeu de résultats interne mis en mémoire tampon. mysqli_stmt_store_result() doit être appelée avant la fonction mysqli_stmt_data_seek().

### Liste de paramètres

`statement`
  Style procédural uniquement : Un objet mysqli_stmt retourné par la fonction mysqli_stmt_init().
`offset`

  Doit prendre une valeur entre zéro et le nombre total de lignes moins 1 (0..mysqli_stmt_num_rows() - 1).

### Valeurs de retour

Aucune valeur n'est retournée.

### Exemples

Exemple #1 Style orienté objet

    <?php

    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name";
    $stmt = $mysqli->prepare($query);
    $stmt->execute();

    $stmt->bind_result($name, $code);

    $stmt->store_result();

    /* Lit la ligne n°400 */
    $stmt->data_seek(399);

    $stmt->fetch();

    printf("Ville : %s  Code Pays : %s\n", $name, $code);

Exemple #2 Style procédural

    <?php

    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $link = mysqli_connect("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name";
    $stmt = mysqli_prepare($link, $query);

    mysqli_stmt_execute($stmt);

    mysqli_stmt_bind_result($stmt, $name, $code);

    mysqli_stmt_store_result($stmt);

    /* Lit la ligne n°400 */
    mysqli_stmt_data_seek($stmt, 399);

    mysqli_stmt_fetch($stmt);

    printf("Ville : %s  Code Pays : %s\n", $name, $code);

L'exemple ci-dessus va afficher :

    Ville : Benin City  Code Pays : NGA

### Voir aussi

- mysqli_prepare() - Prépare une requête SQL pour l'exécution
- mysqli_stmt_store_result() - Stocke un ensemble de résultats dans un tampon interne
- mysqli_stmt_num_rows() - Retourne le nombre de lignes extraites du serveur
- mysqli_data_seek() - Déplace le pointeur interne de résultat

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open