my_ulonglong mysql_affected_rows(MYSQL *mysql)

Beschreibung

Liefert die Anzahl der vom letzten UPDATE aktualisierten, vom letzten DELETE gelöschten oder vom letzten INSERT eingefügten Zeilen. Kann für UPDATE-, DELETE- oder INSERT-Anweisungen direkt nach mysql_query() aufgerufen werden. Bei SELECT-Anweisungen funktioniert mysql_affected_rows() genau wie mysql_num_rows().

Rückgabewerte

Ein Integer größer null zeigt die Anzahl der betroffenen oder abgerufenen Zeilen an. Null bedeutet, dass mit dem UPDATE keine Zeilen aktualisiert wurden, dass keine Zeilen zu der WHERE-Klausel der Anfrage gepasst haben oder die Anfrage noch gar nicht ausgeführt worden ist. -1 bedeutet, dass die Anfrage einen Fehler zurückgeliefert hat oder, bei einer SELECT-Anfrage, dass mysql_affected_rows() vor mysql_store_result() aufgerufen wurde. Da mysql_affected_rows() einen vorzeichenlosen Wert liefert, können Sie -1 feststellen, indem Sie den Rückgabewert mit (my_ulonglong)-1 vergleichen (oder mit (my_ulonglong)~0; das ist dasselbe).

Fehler

Keine.

Beispiel

mysql_query(&mysql,"UPDATE products SET cost=cost*1.25 WHERE group=10");
printf("%ld products updated",(long) mysql_affected_rows(&mysql));

Wenn Sie bei einer Verbindung mit mysqld das Flag CLIENT_FOUND_ROWS angeben, liefert mysql_affected_rows() die Anzahl der Zeilen, die die WHERE-Klausel von UPDATE-Anweisungen erkannt hat.

Beachten Sie, dass mysql_affected_rows() bei Verwendung eines REPLACE-Befehls 2 liefert, wenn die neue Zeile eine alte ersetzt, da hier eine Zeile eingefügt wird, nachdem das Duplikat gelöscht worden ist.

Wenn Sie mit INSERT ... ON DUPLICATE KEY UPDATE eine Zeile einfügen, liefert mysql_affected_rows() den Wert 1, wenn die Zeile als neue Zeile eingefügt wurde, und 2, wenn eine vorhandene Zeile geändert wurde.