pg_fetch_row
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_row — Liefert einen Datensatz als numerisches Array
Beschreibung
pg_fetch_row() holt einen Datensatz der Ergebnismenge,
die durch die result
-Instanz bezeichnet
wird.
Hinweis: Diese Funktion setzt NULL-Felder auf den PHP Wert-
null
.
Parameter-Liste
-
result
-
Eine PgSql\Result-Instanz, die von pg_query(), pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.
-
row
-
Die Nummer der Zeile des Abfrageergebnisses, die geholt werden soll. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter oder ist er
null
, so wird jeweils die nächste Zeile geholt. -
mode
-
Ein optionaler Parameter, der bestimmt, wie das zurückgegebene Array indiziert werden soll.
mode
ist eine Konstante, die einen der folgenden Werte annehmen kann:PGSQL_ASSOC
,PGSQL_NUM
undPGSQL_BOTH
. Wenn die Funktion mitPGSQL_NUM
aufgerufen wird, wird ein Array mit numerischen Indizes zurückgegeben, mitPGSQL_ASSOC
wird ein Array mit assoziatives Indizes zurückgegeben und mitPGSQL_BOTH
ein Array mit beiden Indizes.
Rückgabewerte
Ein array, beginnend bei Index 0, bei dem jeder Wert als
string dargestellt wird. Nullwerte der Datenbank
(NULL
) werden als null
zurückgegeben.
Bei einem Fehler oder wenn der Parameter row
größer
als die Anzahl der Zeilen im Abfrageergebnis ist oder wenn kein Datensatz
mehr gelesen werden kann, wird false
zurückgegeben.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter result erwartet nun eine PgSql\Result-Instanz;
vorher wurde eine Ressource erwartet.
|
Beispiele
Beispiel #1 pg_fetch_row()-Beispiel
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Konnte keine Verbindung aufbauen.\n";
exit;
}
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
while ($row = pg_fetch_row($result)) {
echo "Autor: $row[0] E-mail: $row[1]";
echo "<br />\n";
}
?>
Siehe auch
- pg_query() - Führt eine Abfrage aus
- pg_fetch_array() - Liefert eine Zeile als Array
- pg_fetch_object() - Liefert einen Datensatz als Objekt
- pg_fetch_result() - Liefert Werte aus einer Ergebnisinstanz