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

8.4.3.36. mysql_list_tables()

MYSQL_RES *mysql_list_tables(MYSQL *mysql, const char *wild)

Описание

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

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

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

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

Ошибки

• CR_COMMANDS_OUT_OF_SYNC

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

• CR_SERVER_GONE_ERROR

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

• CR_SERVER_LOST

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

• CR_UNKNOWN_ERROR

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