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 Подготовленные Запросы Структуры Данных».) Если вам всё-таки нужны значения 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.