sqlsrv_get_field

  • [アーティクル]

PHP ドライバーのダウンロード

現在の行の指定したフィールドからデータを取得します。 フィールドのデータには、順にアクセスする必要があります。 たとえば、2 つ目のフィールドのデータにアクセスした後に、1 つ目のフィールドのデータにアクセスすることはできません。

構文

sqlsrv_get_field( resource $stmt, int $fieldIndex [, int $getAsType])

パラメーター

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

$fieldIndex: 取得するフィールドのインデックス。 インデックスは 0 から始まります。

$getAsType [省略可能]: 返されるデータの PHP データ型を決定する SQLSRV 定数 (SQLSRV_PHPTYPE_*)。 サポートされるデータ型については、「定数 (Microsoft Drivers for PHP for SQL Server)」を参照してください。 戻り値の型が指定されていない場合、既定の PHP 型が返されます。 既定の PHP 型の詳細については、「 Default PHP Data Types」を参照してください。 PHP データ型の指定については、「 How to: Specify PHP Data Types」を参照してください。

戻り値

フィールドのデータ。 $getAsType パラメーターを指定して、返されるデータの PHP データ型を指定できます。 戻り値のデータ型が指定されていない場合、既定の PHP データ型が返されます。 既定の PHP 型の詳細については、「 Default PHP Data Types」を参照してください。 PHP データ型の指定については、「 How to: Specify PHP Data Types」を参照してください。

解説

sqlsrv_fetch と sqlsrv_get_field の組み合わせでは、データに対する順方向専用のアクセスが提供されます。

sqlsrv_fetch/sqlsrv_get_field の組み合わせでは、結果セット行の 1 フィールドのみがスクリプト メモリに読み込まれ、PHP の戻り値の型を指定できます (PHP 戻り値の型を指定する方法については、「方法: PHP データ型を指定する」を参照してください)。また、この関数の組み合わせで、データをストリームとして取得することもできます (ストリームとしてのデータの取得については、「SQLSRV ドライバーを使用してデータをストリームとして取得する」を参照してください)。

例

次の例では、製品のレビューとレビュアー名を含むデータの行を取得します。 結果セットからデータを取得するには、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 the SQL Server nvarchar type. */  
$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);  
?>

参照

SQLSRV ドライバー API リファレンス

データの取得

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