PHP マニュアル
前のページ |  | 次のページ

# mysql_affected_rows

(PHP 3, PHP 4 )

mysql_affected_rows -- 一番最近のクエリーで変更された行の数を得る

## 説明

int mysql_affected_rows ( int `[link_identifier]`)

mysql_affected_rows()は、指定した `link_identifier` が指すサーバーにおいて直近 のINSERT、UPDATE、DELETEクエリーにより変更された行の数を返します。 link_identifierが指定されない場合、 mysql_connect() により直近にオープンされたリン クが指定されたと仮定されます。

> 注意 トランザクションを使用する場合には、 コミット後ではなく、INSERT, UPDATE, DELETE クエリの後に mysql_affected_rows() をコールする必要があり ます。

直近のクエリーがWHERE節のないDELETEクエリーであった場合、全レコー ドはテーブルから削除されていますが、この関数はゼロを返します。

> 注意 UPDATEを使用する場合、MySQL は新しい値が古い値と同じ場合にはカラ ムを更新しません。このため、 mysql_affected_rows() はマッチした行の数には 一致しない可能性があり、単にクエリにより文字の上で作用された行 の数となります。

mysql_affected_rows() は、SELECT文には使用でき ません。レコードを修正する文でのみ使用できます。SELECTから返され る行の数を得る際には、mysql_num_rows()を使用し て下さい。

直近のクエリが失敗した場合、この関数は-1を返します。

mysql_num_rows() も参照下さい。

前のページ | ホーム | 次のページ
MySQL関数 | 上に戻る | mysql_change_user