8.4. Интерфейс C для MySQL
8.4.3. Описание функций интерфейса C

8.4.3.34. mysql_list_fields()

MYSQL_RES *mysql_list_fields(MYSQL *mysql, const char *table, const char *wild)

Описание

Возвращает результирующий набор, состоящий из имен полей в заданной таблице, встречающихся в простом регулярном выражении, указанном в параметре wild. Параметр wild может содержать шаблонные символы "%" или "_", а также может быть указателем NULL, что соответствует всем полям. Вызов функции mysql_list_fields() аналогичен выполнению запроса SHOW COLUMNS FROM tbl_name [LIKE wild].

Следует учитывать, что рекомендуется использовать команду SHOW COLUMNS FROM tbl_name вместо функции mysql_list_fields().

Результирующий набор необходимо освободить с помощью функции mysql_free_result().

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

Результирующий набор MYSQL_RES при успешном выполнении. NULL, если произошла ошибка.

Ошибки

• CR_COMMANDS_OUT_OF_SYNC

  Команды были выполнены в ненадлежащем порядке.

• CR_SERVER_GONE_ERROR

  Сервер MySQL неожиданно завершил работу.

• CR_SERVER_LOST

  Соединение с сервером прервалось в процессе данного запроса.

• CR_UNKNOWN_ERROR

  Произошла неизвестная ошибка.