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

# fbsql_affected_rows

(PHP 4 >= 4.0.6, PHP 5)

fbsql_affected_rows -- 直近のFrontBase処理により作用を受けたレコードの数を得る

## 説明

int fbsql_affected_rows ( [int link_identifier])

fbsql_affected_rows() は、 link_identifierが指す接続において 直近のINSERT, UPDATE, DELETEクエリで作用されたレコードの数を返し ます。リンクIDが指定されない場合、 fbsql_connect()により直近にオープンされた接続 が使用されます。

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

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

> 注意: UPDATEを使用する場合、FrontBaseは、新しい値が古い値と同じ場合に はカラムを更新しません。このため、 fbsql_affected_rows()は、実際にはマッチした行 の数と一致しない可能性があり、クエリにより実際に変更された行の数 だけとなります。

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

fbsql_num_rows()も参照下さい。

前のページ | ホーム | 次のページ
FrontBase関数 | 上に戻る | fbsql_autocommit