Перемещает внутренний указатель результирующего набора на заданный столбец

# cubrid_field_seek

(PECL CUBRID >= 8.3.0)

cubrid_field_seek — Перемещает внутренний указатель результирующего набора на заданный столбец

### Описание

function cubrid_field_seek(resource `$result`, int `$field_offset` = 0): bool

Функция перемещает внутренний указатель результирующего набора на указанный столбец. Это смещение используется функцией cubrid_fetch_field(), если не указан параметр offset. Возвращает `true` либо `false` в зависимости от успешности выполнения.

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

`result`
  Значение `result`, который вернула функция cubrid_execute().
`field_offset`
  Индекс поля в строке результирующего набора. `field_offset` начинается с 0. Если `field_offset` не задан, то будет вызвана ошибка уровня `E_WARNING`.

### Возвращаемые значения

Функция возвращает `true` в случае успешного выполнения.

Функция возвращает `false`, если возникла ошибка.

### Примеры

Пример #1 Пример использования функции cubrid_field_seek()

    <?php

    $conn = cubrid_connect("localhost", 33000, "demodb");
    $req = cubrid_execute($conn, "SELECT event_code,athlete_code,nation_code,game_date FROM game WHERE host_year=1988 and event_code=20001;");

    var_dump(cubrid_fetch_row($req));

    cubrid_field_seek($req, 1);
    $field = cubrid_fetch_field($req);

    printf("\n--- Свойства поля ---\n");
    printf("%-30s %s\n", "имя столбца:", $field->name);
    printf("%-30s %s\n", "имя таблицы:", $field->table);
    printf("%-30s \"%s\"\n", "значение столбца по умолчанию:", $field->def);
    printf("%-30s %d\n", "максимальная длина столбца:", $field->max_length);
    printf("%-30s %d\n", "не может быть NULL:", $field->not_null);
    printf("%-30s %d\n", "является уникальным ключом:", $field->unique_key);
    printf("%-30s %d\n", "является неуникальным ключом:", $field->multiple_key);
    printf("%-30s %d\n", "содержит числовое значение:", $field->numeric);
    printf("%-30s %s\n", "тип столбца:", $field->type);

    cubrid_close_request($req);

    cubrid_disconnect($conn);

    ?>

Результат выполнения приведённого примера:

    array(4) {
      [0]=>
      string(5) "20001"
      [1]=>
      string(5) "16132"
      [2]=>
      string(3) "KOR"
      [3]=>
      string(9) "1988-09-30"
    }

    --- Свойства поля ---
    имя столбца:                         athlete_code
    имя таблицы:                         game
    значение столбца по умолчанию:           ""
    максимальная длина столбца:             0
    не может быть NULL:                  1
    является уникальным ключом:             1
    является неуникальным ключом:           0
    содержит числовое значение:             1
    тип столбца:                          integer

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