5.4.17 mysql_fetch_field()

MYSQL_FIELD *
mysql_fetch_field(MYSQL_RES *result)

Описание

Возвращает определение одного столбца набора результатов в виде структуры MYSQL_FIELD. Вызывайте эту функцию многократно, чтобы получить информацию обо всех столбцах в наборе результатов. mysql_fetch_field() возвращает NULL, когда больше столбцов нет.

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

Если вы вызвали mysql_real_query() или mysql_query() для выполнения запроса к таблице, но не вызвали mysql_store_result(), MySQL возвращает значение по умолчанию для длины BLOB (8 КБ), если вы вызываете mysql_fetch_field() для получения длины поля. (Размер 8 КБ выбран, потому что MySQL не знает максимальную длину. Это следует сделать настраиваемым в будущем.) После получения набора результатов, field->max_length содержит длину самого большого значения для этого столбца в конкретном запросе.

Значения возврата

Структура MYSQL_FIELD для текущего столбца. NULL, если столбцы закончились.

Ошибки

Нет.

Пример

MYSQL_FIELD *field;

while((field = mysql_fetch_field(result)))
{
    printf("field name %s\n", field->name);
}