fbsql_affected_rows

(PHP 4 >= 4.0.6, PHP 5)

fbsql_affected_rows --  直近の FrontBase 操作により変更されたレコードの数を得る

説明

int fbsql_affected_rows ( [resource 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() も参照ください。