PHP 8.1.28 Released!

sqlsrv_fetch

(No version information available, might only be in Git)

sqlsrv_fetchДелает следующую строку в наборе результатов доступной для чтения

Описание

sqlsrv_fetch(resource $stmt, int $row = ?, int $offset = ?): mixed

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

Список параметров

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, если следующая строка набора результатов была успешно получена, false в случае возникновения ошибки и null, если в наборе результатов больше нет строк.

Примеры

Пример #1 Пример использования sqlsrv_fetch()

В следующем примере показано, как получить строку с помощью sqlsrv_fetch() и получить поля строки с помощью sqlsrv_get_field().

<?php
$serverName
= "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if(
$conn === false ) {
die(
print_r( sqlsrv_errors(), true));
}

$sql = "SELECT Name, Comment
FROM Table_1
WHERE ReviewID=1"
;
$stmt = sqlsrv_query( $conn, $sql);
if(
$stmt === false ) {
die(
print_r( sqlsrv_errors(), true));
}

// Сделайте первую (и в данном случае единственную) строку набора результатов доступной для чтения.
if( sqlsrv_fetch( $stmt ) === false) {
die(
print_r( sqlsrv_errors(), true));
}

// Получите поля строки. Индексы полей начинаются с 0 и должны извлекаться по порядку.
// Получение полей строки по имени не поддерживается sqlsrv_get_field.
$name = sqlsrv_get_field( $stmt, 0);
echo
"$name: ";

$comment = sqlsrv_get_field( $stmt, 1);
echo
$comment;
?>

Смотрите также

  • sqlsrv_get_field() - Получает данные поля из текущей выбранной строки
  • sqlsrv_fetch_array() - Возвращает строку как массив
  • sqlsrv_fetch_object() - Получает следующую строку данных в наборе результатов как объект

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top