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(PgSql\Result$result): int

    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

    VersionBeschreibung
    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
    To Top