my_ulonglong mysql_stmt_affected_rows(MYSQL_STMT *stmt)

説明

最後に実行されたステートメントによって変更、削除、または挿入されたレコードの合計数を返します。UPDATE、DELETE、または INSERT のいずれかのステートメントに対して mysql_execute() を呼び出した直後に呼び出される可能性があります。SELECT ステートメントの場合、mysql_stmt_affected_rows() を呼び出すと、mysql_num_rows() と同様に動作します。

戻り値

正の整数は、影響を与えた、または取得した、レコード数を示します。0 は、UPDATE によって更新されたレコードがなかったこと、クエリの WHERE 節に一致するレコードがなかったこと、またはクエリが実行されていないことを示します。−1 は、クエリがエラーを返したこと、または SELECT クエリの場合に mysql_fetch() を呼び出す前に mysql_stmt_affected_rows() が呼び出されたことを示します。

エラー

ありません。

例

mysql_stmt_affected_rows() の使用方法については、項11.1.7.5. 「mysql_execute()」 の「例」を参照してください。