- 24.2.7 C-API Prepared Statements: Funktionsbeschreibungen
- 24.2.7.1 mysql_stmt_affected_rows()
- 24.2.7.2 mysql_stmt_attr_get()
- 24.2.7.3 mysql_stmt_attr_set()
- 24.2.7.4 mysql_stmt_bind_param()
- 24.2.7.5 mysql_stmt_bind_result()
- 24.2.7.6 mysql_stmt_close()
- 24.2.7.7 mysql_stmt_data_seek()
- 24.2.7.8 mysql_stmt_errno()
- 24.2.7.9 mysql_stmt_error()
- 24.2.7.10 mysql_stmt_execute()
- 24.2.7.11 mysql_stmt_fetch()
- 24.2.7.12 mysql_stmt_fetch_column()
- 24.2.7.13 mysql_stmt_field_count()
- 24.2.7.14 mysql_stmt_free_result()
- 24.2.7.15 mysql_stmt_init()
- 24.2.7.16 mysql_stmt_insert_id()
- 24.2.7.17 mysql_stmt_num_rows()
- 24.2.7.18 mysql_stmt_param_count()
- 24.2.7.19 mysql_stmt_param_metadata()
- 24.2.7.20 mysql_stmt_prepare()
- 24.2.7.21 mysql_stmt_reset()
- 24.2.7.22 mysql_stmt_result_metadata()
- 24.2.7.23 mysql_stmt_row_seek()
- 24.2.7.24 mysql_stmt_row_tell()
- 24.2.7.25 mysql_stmt_send_long_data()
- 24.2.7.26 mysql_stmt_sqlstate()
- 24.2.7.27 mysql_stmt_store_result()
my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT
*stmt)
Beschreibung
Diese Funktion gibt die Gesamtzahl der von der zuletzt
ausgeführten Anweisung geänderten, gelöschten oder
eingefügten Zeilen zurück. Für UPDATE-,
DELETE- oder
INSERT-Anweisungen kann sie unmittelbar
nach mysql_stmt_execute() aufgerufen
werden. Für SELECT-Anweisungen arbeitet
mysql_stmt_affected_rows() genau wie
mysql_num_rows().
Rückgabewerte
Ein Integer größer null zeigt die Anzahl der betroffenen
oder abgerufenen Zeilen an. Null zeigt für eine
UPDATE-Anweisung an, dass keine Zeilen
aktualisiert wurden, für eine
WHERE-Klausel in der Anfrage, dass keine
Zeilen gepasst haben, oder ansonsten, dass die Anfrage noch
gar nicht ausgeführt wurde. -1 bedeutet, dass die Anfrage
einen Fehler zurückgeliefert hat oder, bei einer
SELECT-Anfrage, dass
mysql_stmt_affected_rows() vor
mysql_stmt_store_result() aufgerufen wurde.
Da mysql_stmt_affected_rows() einen
vorzeichenlosen Wert liefert, können Sie -1 überprüfen,
indem Sie den Rückgabewert mit
(my_ulonglong)-1 (oder dem Äquivalent
(my_ulonglong)~0) vergleichen.
Weitere Informationen über den Rückgabewert finden Sie unter
Abschnitt 24.2.3.1, „mysql_affected_rows()“.
Fehler
Keine.
Beispiel
Ein Anwendungsbeispiel für
mysql_stmt_affected_rows() finden Sie im
Beispiel von Abschnitt 24.2.7.10, „mysql_stmt_execute()“.
Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.
