CakeFest 2024: The Official CakePHP Conference

mysqli_result::field_seek

mysqli_field_seek

(PHP 5, PHP 7, PHP 8)

mysqli_result::field_seek -- mysqli_field_seekУстанавливает указатель результата на заданное смещение поля

Описание

Объектно-ориентированный стиль

public mysqli_result::field_seek(int $index): true

Процедурный стиль

mysqli_field_seek(mysqli_result $result, int $index): true

Устанавливает указатель поля на заданное смещение. Следующий вызов функции mysqli_fetch_field() извлечёт определение поля столбца, который связан со смещением.

Замечание:

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

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

result

Только для процедурного стиля: объект mysqli_result, который вернула функция mysqli_query(), mysqli_store_result(), mysqli_use_result() или mysqli_stmt_get_result().

index

Номер поля. Это значение должно быть в следующем диапазоне: от 0 до количество полей - 1.

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

Функция всегда возвращает true.

Список изменений

Версия Описание
8.0.0 Теперь функция каждый раз возвращает значение true. Раньше функция возвращала значение false, если возникала ошибка.

Примеры

Пример #1 Объектно-ориентированный стиль

<?php

$mysqli
= new mysqli("localhost", "my_user", "my_password", "world");

/* Проверить соединение */
if (mysqli_connect_errno()) {
printf("Ошибка соединения: %s\n", mysqli_connect_error());
exit();
}

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if (
$result = $mysqli->query($query)) {

/* Получить информацию о поле во втором столбце */
$result->field_seek(1);
$finfo = $result->fetch_field();

printf("Имя: %s\n", $finfo->name);
printf("Таблица: %s\n", $finfo->table);
printf("Макс. длина: %d\n", $finfo->max_length);
printf("Флаги: %d\n", $finfo->flags);
printf("Тип: %d\n\n", $finfo->type);

$result->close();
}

/* Закрыть соединение */
$mysqli->close();

?>

Пример #2 Процедурный стиль

<?php

$link
= mysqli_connect("localhost", "my_user", "my_password", "world");

/* Проверить соединение */
if (mysqli_connect_errno()) {
printf("Ошибка соединения: %s\n", mysqli_connect_error());
exit();
}

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if (
$result = mysqli_query($link, $query)) {

/* Получить информацию о поле во втором столбце */
mysqli_field_seek($result, 1);
$finfo = mysqli_fetch_field($result);

printf("Имя: %s\n", $finfo->name);
printf("Таблица: %s\n", $finfo->table);
printf("Макс. длина: %d\n", $finfo->max_length);
printf("Флаги: %d\n", $finfo->flags);
printf("Тип: %d\n\n", $finfo->type);

mysqli_free_result($result);
}

/* Закрыть соединение */
mysqli_close($link);

?>

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

Имя:     SurfaceArea
Таблица:    Country
Макс. длина: 10
Флаги:    32769
Тип:     4

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

  • mysqli_fetch_field() - Возвращает следующее поле результирующего набора

add a note

User Contributed Notes

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