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 mysqli_stmt::data_seek(int $offset): void

Style procédural

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