PHP Dokumentation: Function pg-affected-rows
12. Januar 2010 von werner
pg_affected_rows
(PHP 4 >= 4.2.0, PHP 5)
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.
Hinweis: Diese Funktion hieß vormals pg_cmdtuples().
Parameter-Liste
- result
PostgreSQL Ergebniskennung, die (unter anderem) von den Funktionen pg_query(), pg_query_params() oder pg_execute() zurückgegeben wird.
Rückgabewerte
Die Anzahl der Zeilen, die von der Abfrage betroffen wurden. Wurde keine Zeile betroffen, wird 0 zurückgegeben.
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 folgendeAusgabe:
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