sqlsrv_rows_affected

最後に実行されたステートメントで変更された行の数を返します。この関数は、SELECT ステートメントから返される行の数は返しません。

構文

sqlsrv_rows_affected( resource $stmt)

パラメータ

$stmt: 実行されるステートメントに対応するステートメント リソース。

戻り値

最後に実行されたステートメントで変更された行の数を表す整数。変更された行がない場合、ゼロ (0) が返されます。変更された行の数に関する情報が入手できない場合、-1 が返されます。変更された行の数を取得する際にエラーが発生した場合、false が返されます。

例

次の例では、UPDATE ステートメントで変更された行の数を表示します。この例では、SQL Server と AdventureWorks データベースがローカル コンピュータにインストールされていることを前提としています。この例をコマンド ラインから実行した場合、すべての出力はコンソールに書き込まれます。

<?php
/* Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
     echo "Could not connect.\n";
     die( print_r( sqlsrv_errors(), true));
}

/* Set up Transact-SQL query. */
$tsql = "UPDATE Sales.SalesOrderDetail 
         SET SpecialOfferID = ? 
         WHERE ProductID = ?";

/* Set parameter values. */
$params = array(2, 709);

/* Execute the statement. */
$stmt = sqlsrv_query( $conn, $tsql, $params);

/* Get the number of rows affected and display appropriate message.*/
$rows_affected = sqlsrv_rows_affected( $stmt);
if( $rows_affected === false)
{
     echo "Error in calling sqlsrv_rows_affected.\n";
     die( print_r( sqlsrv_errors(), true));
}
elseif( $rows_affected == -1)
{
      echo "No information available.\n";
}
else
{
      echo $rows_affected." rows were updated.\n";
}

/* Free statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>

参照

概念

ドキュメントのコード例について

その他のリソース

API リファレンス (SQL Server Driver for PHP)
データの更新 (SQL Server Driver for PHP)