char * name

Имя поля в виде строки с нулевым завершением. Если для поля был задан псевдоним с помощью предложения AS, то значение name — это псевдоним. Для параметра процедуры — это имя параметра.

char * org_name

Имя поля в виде строки с нулевым завершением. Псевдонимы игнорируются. Для выражений значение — пустая строка. Для параметра процедуры — это имя параметра.

char * table

Имя таблицы, содержащей это поле, если это не вычисляемое поле. Для вычисляемых полей значение table — пустая строка. Если столбец выбран из представления, то table содержит имя представления. Если таблице или представлению был задан псевдоним с помощью предложения AS, то значение table — это псевдоним. Для процедуры значение — пустая строка. Для параметра процедуры — это имя процедуры.

char * org_table

Имя таблицы в виде строки с нулевым завершением. Псевдонимы игнорируются. Если столбец выбран из представления, то org_table содержит имя представления. Если столбец выбран из производной таблицы, то org_table содержит имя базовой таблицы. Если производная таблица оборачивает представление, то org_table всё равно содержит имя базовой таблицы. Если столбец является выражением, то org_table — пустая строка. Для процедуры значение — пустая строка. Для параметра процедуры значение — имя процедуры.

char * db

Имя базы данных, из которой происходит поле, в виде строки с нулевым завершением. Если поле является вычисляемым, то db — пустая строка. Для процедуры значение — пустая строка. Для параметра процедуры — это имя базы данных, содержащей процедуру.

char * catalog

Имя каталога. Это значение всегда "def".

char * def

Значение по умолчанию этого поля в виде строки с нулевым завершением. Устанавливается только при использовании mysql_list_fields().

unsigned long length

Ширина поля. Соответствует длине отображения в байтах.

Сервер определяет значение length перед генерацией набора результатов, поэтому это минимальная длина, необходимая для типа данных, способного хранить наибольшее возможное значение из столбца результата, без предварительного знания фактических значений, которые будут произведены запросом для набора результатов.

Для строковых столбцов значение length варьируется в зависимости от набора символов подключения. Например, если набор символов — latin1 (однобайтовый набор символов), значение length для запроса SELECT 'abc' составляет 3. Если набор символов — utf8mb4 (многобайтовый набор символов, в котором символы занимают до 4 байтов), то значение length составляет 12.

unsigned long max_length

Максимальная ширина поля для набора результатов (длина в байтах самого длинного значения поля для строк, фактически находящихся в наборе результатов). При использовании mysql_store_result() или mysql_list_fields(), это содержит максимальную длину поля. Если используется mysql_use_result(), значение этой переменной равно нулю.

Значение max_length — это длина строкового представления значений в наборе результатов. Например, если извлекается столбец и “наибольшее” значение — -12.345, то max_length составляет 7 (длина '-12.345').

При использовании подготовленных запросов max_length по умолчанию не устанавливается, потому что для двоичного протокола длины значений зависят от типов значений в наборе результатов. (См. Раздел 6.2, «C API Prepared Statement Data Structures».) Если вам все же нужны значения max_length, включите параметр STMT_ATTR_UPDATE_MAX_LENGTH с помощью mysql_stmt_attr_set(), и длины будут установлены при вызове mysql_stmt_store_result(). (См. Раздел 6.4.3, «mysql_stmt_attr_set()» и Раздел 6.4.28, «mysql_stmt_store_result()».)

unsigned int name_length

Длина name.

unsigned int org_name_length

Длина org_name.

unsigned int table_length

Длина table.

unsigned int org_table_length

Длина org_table.

unsigned int db_length

Длина db.

unsigned int catalog_length

Длина catalog.

unsigned int def_length

Длина def.

unsigned int flags

Битовые флаги, описывающие поле. Значение flags может иметь один или несколько установленных битов, показанных в следующей таблице.

Некоторые из этих флагов указывают на информацию о типе данных и заменяются или используются совместно со значением MYSQL_TYPE_xxx в члене field->type, описанном позже:

NUM_FLAG указывает, что столбец числовой. Это включает столбцы с типом MYSQL_TYPE_DECIMAL, MYSQL_TYPE_NEWDECIMAL, MYSQL_TYPE_TINY, MYSQL_TYPE_SHORT, MYSQL_TYPE_LONG, MYSQL_TYPE_FLOAT, MYSQL_TYPE_DOUBLE, MYSQL_TYPE_NULL, MYSQL_TYPE_LONGLONG, MYSQL_TYPE_INT24 и MYSQL_TYPE_YEAR.

NO_DEFAULT_VALUE_FLAG указывает, что столбец не имеет предложения DEFAULT в его определении. Это не относится к столбцам NULL (поскольку такие столбцы имеют значение по умолчанию NULL) или к столбцам AUTO_INCREMENT (которые имеют подразумеваемое значение по умолчанию).

Следующий пример иллюстрирует типичное использование значения flags:

if (field->flags & NOT_NULL_FLAG)
    printf("Field cannot be null\n");

Для определения логического состояния значения flags вы можете использовать вспомогательные макросы, представленные в следующей таблице.

unsigned int decimals

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

unsigned int charsetnr

Идентификационный номер, указывающий пару набор символов/кодировка для поля.

Обычно символьные значения в наборах результатов преобразуются в набор символов, указанный переменной системы. В этом случае charsetnr соответствует набору символов, указанному этой переменной. Преобразование наборов символов можно отключить, установив в значение NULL. В этом случае charsetnr соответствует набору символов исходного столбца таблицы или выражения. См. также .

Чтобы отличить двоичные и недвоичные данные для строковых типов данных, проверьте, равно ли значение charsetnr 63. Если да, то набор символов — binary, что указывает на двоичные, а не недвоичные данные. Это позволяет вам отличить от , от , и типы от типов .

Значения charsetnr совпадают с отображаемыми в столбце Id выражения или столбце ID таблицы INFORMATION_SCHEMA . Вы можете использовать эти источники информации, чтобы увидеть, какие значения charsetnr указывают на конкретный набор символов и кодировку:

mysql> SHOW COLLATION WHERE Id = 63;
+-----------+---------+----+---------+----------+---------+
| Collation | Charset | Id | Default | Compiled | Sortlen |
+-----------+---------+----+---------+----------+---------+
| binary    | binary  | 63 | Yes     | Yes      |       1 |
+-----------+---------+----+---------+----------+---------+

mysql> SELECT COLLATION_NAME, CHARACTER_SET_NAME
       FROM INFORMATION_SCHEMA.COLLATIONS WHERE ID = 33;
+-----------------+--------------------+
| COLLATION_NAME  | CHARACTER_SET_NAME |
+-----------------+--------------------+
| utf8_general_ci | utf8               |
+-----------------+--------------------+

enum enum_field_types type

Тип поля. Значение type может быть одним из символов, показанных в следующей таблице.

Коды типов MYSQL_TYPE_TIME2, MYSQL_TYPE_DATETIME2 и MYSQL_TYPE_TIMESTAMP2 используются только на стороне сервера. Клиенты видят коды MYSQL_TYPE_TIME, MYSQL_TYPE_DATETIME и MYSQL_TYPE_TIMESTAMP.

Вы можете использовать макрос IS_NUM(), чтобы проверить, имеет ли поле числовой тип. Передайте значение type в IS_NUM(), и оно вернёт TRUE, если поле является числовым:

if (IS_NUM(field->type))
    printf("Field is numeric\n");

и значения возвращаются как строки. Для них проверьте, что значение type равно MYSQL_TYPE_STRING, и что флаг ENUM_FLAG или SET_FLAG установлен в значении flags.