pg_fetch_assoc
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_fetch_assoc — Liefert eine Zeile als assoziatives Array
Beschreibung
pg_fetch_assoc() gibt eine Zeile eines Abfrageergebnisses als assoziatives Array zurück.
pg_fetch_assoc() ist äquivalent zu
pg_fetch_array() mit PGSQL_ASSOC
als optionalem dritten Parameter. Zurückgegeben wird nur ein assoziatives
Array. Falls Sie ein numerisches Array brauchen, müssen Sie die Funktion
pg_fetch_row() benutzen.
Hinweis: Diese Funktion setzt NULL-Felder auf den PHP Wert-
null.
pg_fetch_assoc() ist nur unwesentlich langsamer als pg_fetch_row(), aber wesentlich einfacher zu benutzen.
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.
Rückgabewerte
Ein array, das mit den Feldnamen des Abfrageergebnisses
indiziert ist. Jeder Wert im array wird als
string repräsentiert. 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_assoc()-Beispiel
<?php
$conn = pg_connect("dbname=publisher");
if (!$conn) {
echo "Konnte keine Verbindung aufbauen.\n";
exit;
}
$result = pg_query($conn, "SELECT id, author, email FROM authors");
if (!$result) {
echo "Ein Fehler ist aufgetreten.\n";
exit;
}
while ($row = pg_fetch_assoc($result)) {
echo $row['id'];
echo $row['author'];
echo $row['email'];
}
?>
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
