pg_fetch_all
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_fetch_all — Liefert alle Zeilen eines Abfrageergebnisses als Array
Beschreibung
pg_fetch_all() gibt ein Array zurück, das alle Zeilen einer PgSql\Result-Instanz enthält.
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.
-
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 mit allen Zeilen des Abfrageergebnisses. Jede Zeile ist ein assoziatives Array mit den Spaltennamen als Indizes und den Werten der Tabellenspalte als Werte.
Changelog
Version | Beschreibung |
---|---|
8.1.0 |
Der Parameter result erwartet nun eine PgSql\Result-Instanz;
vorher wurde eine Ressource erwartet.
|
8.0.0 |
pg_fetch_all() gibt bei Ergebnismengen mit null
Zeilen nun ein leeres Array statt false zurück.
|
7.1.0 |
Der Parameter mode wurde hinzugefügt.
|
Beispiele
Beispiel #1 pg_fetch_all()-Beispiel
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Konnte keine Verbindung aufbauen.\n";
exit;
}
$result = pg_query($conn, "SELECT * FROM authors");
if (!$result) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
$arr = pg_fetch_all($result);
print_r($arr);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Array ( [0] => Array ( [id] => 1 [name] => Fred ) [1] => Array ( [id] => 2 [name] => Bob ) )
Siehe auch
- pg_fetch_row() - Liefert einen Datensatz als numerisches Array
- pg_fetch_array() - Liefert eine Zeile als Array
- pg_fetch_object() - Liefert einen Datensatz als Objekt
- pg_fetch_result() - Liefert Werte aus einer Ergebnisinstanz