pg_affected_rows
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_affected_rows — Gibt die Anzahl betroffener Datensätze (Tupel) zurück
Beschreibung
pg_affected_rows() gibt die Anzahl der Tupels
(Instanzen/Datensätze/Zeilen) zurück, die von einer ausgeführten
INSERT-, UPDATE- oder
DELETE-Abfrage betroffen sind.
Ab PostgreSQL 9.0 und neuer gibt der Server die Anzahl von per SELECT gewählten Zeilen zurück. Ältere PostgreSQL Versionen geben 0 für SELECT zurück.
Hinweis:
Diese Funktion hieß vormals pg_cmdtuples().
Parameter-Liste
-
result -
Eine PgSql\Result-Instanz, die von pg_query(), pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.
Rückgabewerte
Die Anzahl der Zeilen, die von der Abfrage betroffen wurden. Wurde
keine Zeile betroffen, wird 0 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_affected_rows()-Beispiel
<?php
$result = pg_query($conn, "INSERT INTO authors VALUES ('Orwell', 2002, 'Animal Farm')");
$cmdtuples = pg_affected_rows($result);
echo $cmdtuples . " Zeile(n) wurden betroffen.\n";
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
1 Zeile(n) wurden betroffen.
Siehe auch
- pg_query() - Führt eine Abfrage aus
- pg_query_params() - Sendet ein Kommando zum Server und wartet seine Ausführung ab. Getrennt vom SQL-Kommando können dabei Parameter übergeben werden
- pg_execute() - Fordert den Datenankserver auf, eine vorbereitete Anfrage mit den angegebenen Parametern auszuführen und wartet auf das Ergebnis
- pg_num_rows() - Gibt die Anzahl der Zeilen in einem Abfrageergebnis zurück
