mysql_list_fields

List MySQL table fields

&mysql.alternative.note.5-4-0;

- SQL Query: `SHOW COLUMNS FROM sometable`

&reftitle.description; `resource` `mysql_list_fields` `string` `database_name` `string` `table_name` `resource` `link_identifier` NULL

Retrieves information about the given table name.

This function is deprecated. It is preferable to use `mysql_query` to issue an SQL `SHOW COLUMNS FROM table [LIKE 'name']` statement instead.

&reftitle.parameters;

`database_name`

- The name of the database that's being queried.

`table_name`

- The name of the table that's being queried.

&mysql.linkid.description;
&reftitle.returnvalues;

A result pointer `resource` on success, or &false; on failure.

The returned result can be used with `mysql_field_flags`, `mysql_field_len`, `mysql_field_name`&listendand; `mysql_field_type`.

&reftitle.examples;

### Alternate to deprecated `mysql_list_fields`

    <?php
    $result = mysql_query("SHOW COLUMNS FROM sometable");
    if (!$result) {
        echo 'Could not run query: ' . mysql_error();
        exit;
    }
    if (mysql_num_rows($result) > 0) {
        while ($row = mysql_fetch_assoc($result)) {
            print_r($row);
        }
    }
    ?>

&example.outputs.similar;

    Array
    (
        [Field] => id
        [Type] => int(7)
        [Null] =>
        [Key] => PRI
        [Default] =>
        [Extra] => auto_increment
    )
    Array
    (
        [Field] => email
        [Type] => varchar(100)
        [Null] =>
        [Key] =>
        [Default] =>
        [Extra] =>
    )

&reftitle.notes;

&info.deprecated.alias; `mysql_listfields`

&reftitle.seealso;

- `mysql_field_flags`
- `mysql_info`