mysql_data_seek
(PHP 4, PHP 5)
mysql_data_seek — Bewegt den internen Ergebnis-Zeiger
Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt. Verwenden Sie stattdessen die Erweiterungen MySQLi oder PDO_MySQL. Weitere Informationen finden Sie im Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:
- mysqli_data_seek()
PDO::FETCH_ORI_ABS
Beschreibung
$result, int $row_number): boolmysql_data_seek() bewegt den internen Datensatz-Zeiger eines Abfrageergebnisses, das mit der übergebenen Resultkennung verknüpft ist, zu dem Datensatz mit der übergebenen Zeilennummer. Der nächste Aufruf einer MySQL-fetch-Funktion, wie etwa mysql_fetch_row() gibt die entsprechende Zeile zurück.
Die Zeilennummer row_number beginnt bei 0.
row_number sollte ein Wert im Bereich zwischen 0 und
mysql_num_rows() - 1 sein. Falls die Ergebnismenge
jedoch leer sein sollte (mysql_num_rows() == 0), wird
eine Suche nach der Zeilennummer 0 mit einem E_WARNING
fehlschlagen und mysql_data_seek() gibt false zurück.
Parameter-Liste
-
Ergebnis -
Das Ergebnis Ressource, das ausgewertet wird. Dieses Ergebnis kommt von einem Aufruf von mysql_query().
-
row_number -
Die gewünschte Zeilennummer des neuen Ergebnis-Zeigers.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 mysql_data_seek()-Beispiel
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Keine Verbindung möglich: ' . mysql_error());
}
$db_selected = mysql_select_db('sample_db');
if (!$db_selected) {
die('Konnte Datenbank nicht auswählen: ' . mysql_error());
}
$query = 'SELECT last_name, first_name FROM friends';
$result = mysql_query($query);
if (!$result) {
die('Anfrage fehlgeschlagen: ' . mysql_error());
}
/* Hole Zeilen in umgekehrter Reihenfolge */
for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {
if (!mysql_data_seek($result, $i)) {
echo "Kann nicht zu Zeile $i gehen (seek): " . mysql_error() . "\n";
continue;
}
if (!($row = mysql_fetch_assoc($result))) {
continue;
}
echo $row['last_name'] . ' ' . $row['first_name'] . "<br />\n";
}
mysql_free_result($result);
?>
Anmerkungen
Hinweis:
Die Funktion mysql_data_seek() kann nur zusammen mit mysql_query() verwendet werden und nicht mit mysql_unbuffered_query().
Siehe auch
- mysql_query() - Sendet eine Abfrage an MySQL
- mysql_num_rows() - Liefert die Anzahl der Zeilen in einem Ergebnis
- mysql_fetch_row() - Liefert einen Datensatz als indiziertes Array
- mysql_fetch_assoc() - Liefert einen Datensatz als assoziatives Array
- mysql_fetch_array() - Liefert einen Datensatz als assoziatives Array, als numerisches Array oder beides
- mysql_fetch_object() - Liefert eine Ergebniszeile als Objekt
