sesam_affected_rows

(PHP 3 CVS only)

sesam_affected_rows -- 直近のクエリにより作用されたレコードの数を得る

説明

int sesam_affected_rows ( string result_id )

result_id は、 sesam_query() により返された有効な結果 ID です。

result_id に関連するクエリにより作用された レコード数を返します。

sesam_affected_rows() 関数は、"即時型" SQL 命令 (INSERTUPDATEDELETE のような更新処理)との組合せで使用された 場合にのみ有用な値を返します。これは、SESAM が "select型" クエリに 関して "作用されたレコード" に関する情報を返さないためです。返される 数は、作用されたレコードの数です。

例 1. sesam_affected_rows() の例

<?php
$result
= sesam_execimm("DELETE FROM PHONE WHERE LASTNAME = '" . strtoupper($name) . "'");
if (!
$result) {
    
/* ... エラー ... */
}
echo
sesam_affected_rows($result).
    
" 姓が " . $name . " のエントリが削除されました。\n";
?>

sesam_query() および sesam_execimm() も参照ください。