5.4.43 mysql_list_fields()

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

Описание

Примечание

Начиная с MySQL 5.7.11, mysql_list_fields() устарело и может быть удалено в будущей версии MySQL. Вместо этого используйте mysql_real_query() или mysql_query() для выполнения оператора.

Возвращает пустой результат набора, метаданные которого предоставляют информацию о столбцах в заданной таблице, соответствующих простому регулярному выражению, заданному параметром 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 если произошла ошибка.

Ошибки

Команды были выполнены в неправильном порядке.
Сервер MySQL вышел из строя.
Подключение к серверу было потеряно во время запроса.
Произошла неизвестная ошибка.

Пример

int i;
MYSQL_RES *tbl_cols = mysql_list_fields(mysql, "mytbl", "f%");

unsigned int field_cnt = mysql_num_fields(tbl_cols);
printf("Number of columns: %d\n", field_cnt);

for (i=0; i < field_cnt; ++i)
{
  /* col describes i-th column of the table */
  MYSQL_FIELD *col = mysql_fetch_field_direct(tbl_cols, i);
  printf ("Column %d: %s\n", i, col->name);
}
mysql_free_result(tbl_cols);