sqlsrv_fetch

Статья
06/02/2023

Делает следующую строку результирующего набора доступной для чтения. Используйте sqlsrv_get_field для чтения полей строки.

Синтаксис

  
sqlsrv_fetch( resource $stmt[, row[, ]offset])

Параметры

$stmt: ресурс инструкции, соответствующий выполненной инструкции.

Примечание

Перед извлечением результатов необходимо выполнить инструкцию. Сведения о выполнении инструкции см. в статьях sqlsrv_query и sqlsrv_execute.

row (Необязательно). Одно из следующих значений, определяющее строку, к которой требуется получить доступ в результирующем наборе, использующем прокручиваемый курсор.

SQLSRV_SCROLL_NEXT
SQLSRV_SCROLL_PRIOR
SQLSRV_SCROLL_FIRST
SQLSRV_SCROLL_LAST
SQLSRV_SCROLL_ABSOLUTE
SQLSRV_SCROLL_RELATIVE

Дополнительные сведения об этих значениях см. в статье Указание типа курсора и выбор строк.

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);  
?>

См. также:

Извлечение данных

Справочник по API для драйвера SQLSRV

Информация о примерах кода в документации