mysqli_result::fetch_fields
mysqli_fetch_fields
(PHP 5, PHP 7, PHP 8)
mysqli_result::fetch_fields -- mysqli_fetch_fields — Повертає масив об'єктів, що становлять поля результуючого набору
Опис
Об'єктно-орієнтований стиль
public mysqli_result::fetch_fields(): array
Процедурний стиль
mysqli_fetch_fields(mysqli_result $result): array
Ця функція служить для тих же цілей, що й mysqli_fetch_field(), З тією лише різницею, що повертає не один об'єкт для стовпця, а масив таких об'єктів.
Список параметрів
result
Тільки для процедурного стилю: об'єкт mysqli_result, який повернула функція mysqli_query() mysqli_store_result() mysqli_use_result() або mysqli_stmt_get_result()
Значення, що повертаються
Повертає масив об'єктів, що містять метадані полів.
Властивості об'єкту
| Свойство | Опис |
|---|---|
| name | Ім'я стовпця |
| orgname | Вихідне ім'я стовпця, якщо він має псевдонім |
| table | Ім'я таблиці, якій належить стовпець (якщо не обчислено) |
| orgtable | Початкове ім'я таблиці, якщо є псевдонім |
| max_length | Максимальна ширина поля результуючого набору. Починаючи з PHP 8.1, це значення завжди |
| length | Довжина поля в байтах, як вона поставлена при визначенні таблиці. Зверніть увагу, що дана величина (в байтах) може відрізнятися від величини символів, зазначеної у визначенні поля таблиці, оскільки в різних кодуваннях один символ може записуватися кількома байтами. Наприклад, набір символів utf8 має 3 байти на символ, таким чином поле VARCHAR(10) у кодуванні UTF-8 поверне довжину 30 байтів = 10 символів. * 3 байти на символ, а кодування LATIN1 - довжину 10, оскільки у цьому кодуванні один символ займає один байт. |
| charsetnr | Числовий ідентифікатор кодування. |
| flags | Ціла кількість, що представляє бітові прапори для поля. |
| type | Тип даних поля |
| decimals | Число знаків після коми (для цілих полів) |
Приклади
Приклад #1 Об'єктно-орієнтований стиль
Приклад #2 Процедурний стиль
Результат виконання наведених прикладів:
======================
Character Set: latin1
======================
Name: actor_id
Table: actor
Max. Len: 3
Length: 5
charsetnr: 63
Flags: 49699
Type: 2
Name: last_name
Table: actor
Max. Len: 12
Length: 45
charsetnr: 8
Flags: 20489
Type: 253
======================
Character Set: utf8
======================
Name: actor_id
Table: actor
Max. Len: 3
Length: 5
charsetnr: 63
Flags: 49699
Type: 2
Name: last_name
Table: actor
Max. Len: 12
Length: 135
charsetnr: 33
Flags: 20489
Дивіться також
- mysqli_num_fields() - Отримує кількість полів у наборі результатів
- mysqli_fetch_field_direct() - Отримання метаданих конкретного поля
- mysqli_fetch_field() - Повертає наступне поле результуючого набору