Forum und email

fbsql_affected_rows

(PHP 4 >= 4.0.6, PHP 5)

fbsql_affected_rows — Ermittelt die Anzahl der von der vorherigen FrontBase-Operation betroffenen Datensätze

Beschreibung

int fbsql_affected_rows ([ resource $ Verbindungskennung ] )

fbsql_affected_rows() liefert die Anzahl der von der letzten INSERT-, UPDATE- oder DELETE-Abfrage betroffenen Datensätze auf dem Server, der mit der angegebenen Verbindungskennung assoziiert ist. Wenn keine Verbindungskennung angegeben, wird die zuletzt über fbsql_connect() geöffnete Verbindung verwendet.

Hinweis: Falls Sie Transaktionen verwenden, müssen Sie fbsql_affected_rows() unmittelbar nach Ihrer INSERT-, UPDATE-, oder DELETE-Abfrage, nicht nach dem Commit.

War die letzte Abfrage eine DELETE-Anweisung ohne WHERE-Bedingung, wurden zwar alle Datensätze aus der Tabelle gelöscht. Diese Funktion gibt in diesem Falle trotzdem Null(0) zurück.

Hinweis: Benutzen Sie UPDATE, wird FrontBase keine Spalten aktualisieren, bei denen der Neue dem alten Wert entspricht. Die kann dazu führen, dass fbsql_affected_rows() unter umständen nicht die tatsächliche Anzahl der betroffenen Datensätze liefert, sondern nur die, die wörtlich durch die Anfrag betroffen sind.

Falls die letze Anfrage fehlschlägt, liefert diese Funktion -1 zurück.

Siehe auch: fbsql_num_rows().