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

# sqlsrv_fetch

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

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

### Описание

function 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() - Получает следующую строку данных в наборе результатов как объект

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open