sqlsrv_fetch
結果セットの次の行を読み取り可能にします。行のフィールドを読み取るには、sqlsrv_get_field を使用します。
構文
sqlsrv_fetch( resource $stmt[, row[, ]offset])
パラメータ
$stmt: 実行されるステートメントに対応するステートメント リソース。
注意
結果を取得する前に、ステートメントを実行する必要があります。ステートメントの実行については、「sqlsrv_query」および「sqlsrv_execute」を参照してください。
row [オプション]: Version 1.1 で追加されました。スクロール可能なカーソルを使用する、結果セット内のアクセス対象行を指定する、次のいずれかの値です。
- SQLSRV_SCROLL_NEXT
- SQLSRV_SCROLL_PRIOR
- SQLSRV_SCROLL_FIRST
- SQLSRV_SCROLL_LAST
- SQLSRV_SCROLL_ABSOLUTE
- SQLSRV_SCROLL_RELATIVE
これらの値の詳細については、「カーソルの種類の指定と行の選択」を参照してください。スクロール可能なカーソルのサポートは、SQL Server Driver for PHP Version 1.1 で追加されました。
offset [オプション]: 取得する行を指定するには、SQLSRV_SCROLL_ABSOLUTE および SQLSRV_SCROLL_RELATIVE を共に使用します。結果セット内の最初のレコードは 0 です。
戻り値
結果セットの次の行が正常に取得された場合は、true が返されます。結果セットに次の結果がない場合は、null が返されます。エラーが発生した場合は、false が返されます。
例
次の例では、sqlsrv_fetch を使用して製品レビューおよびレビュー担当者の名前を含むデータの行を取得します。結果セットからデータを取得するために、sqlsrv_get_field を使用します。この例では、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 and execute the query. Note that both ReviewerName and
Comments are of SQL Server type nvarchar. */
$tsql = "SELECT ReviewerName, Comments
FROM Production.ProductReview
WHERE ProductReviewID=1";
$stmt = sqlsrv_query( $conn, $tsql);
if( $stmt === false )
{
echo "Error in statement preparation/execution.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Make the first row of the result set available for reading. */
if( sqlsrv_fetch( $stmt ) === false)
{
echo "Error in retrieving row.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Note: Fields must be accessed in order.
Get the first field of the row. Note that no return type is
specified. Data will be returned as a string, the default for
a field of type nvarchar.*/
$name = sqlsrv_get_field( $stmt, 0);
echo "$name: ";
/*Get the second field of the row as a stream.
Because the default return type for a nvarchar field is a
string, the return type must be specified as a stream. */
$stream = sqlsrv_get_field( $stmt, 1,
SQLSRV_PHPTYPE_STREAM( SQLSRV_ENC_CHAR));
while( !feof( $stream ))
{
$str = fread( $stream, 10000);
echo $str;
}
/* Free the statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>