# fbsql_list_fields

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

fbsql_list_fields — List FrontBase result fields

### 说明

fbsql_list_fields ( string `$database_name` , string `$table_name` [, resource `$link_identifier` ] ) : resource

Retrieves information about the given table.

### 参数

`database_name`

  The database name.

`table_name`

  The table name.

`link_identifier`

  由 fbsql_connect() 或 fbsql_pconnect() 返回的 FrontBase 链接标识符.

  如可选并未指定，函数会尝试查找一个到 FrontBase 服务器的开放链接，且如没有找到这样的链接，会尝试通过不带参数调用 fbsql_connect() 来创建一个。

### 返回值

Returns a result pointer which can be used with the fbsql_field_xxx functions, or `FALSE` on error.

### 错误／异常

A string describing the error will be placed in $phperrmsg, and unless the function was called as @fbsql() then this error string will also be printed out.

### 范例

Example #1 fbsql_list_fields() example

    <?php
    $link = fbsql_connect('localhost', 'myname', 'secret');

    $fields = fbsql_list_fields("database1", "table1", $link);
    $columns = fbsql_num_fields($fields);

    for ($i = 0; $i < $columns; $i++) {
        echo fbsql_field_name($fields, $i) . "\n";;
    }
    ?>

以上例程的输出类似于：

    field1
    field2
    field3
    ...

### 参见

- fbsql_field_len() - Returns the length of the specified field
- fbsql_field_name() - Get the name of the specified field in a result
- fbsql_field_type() - Get the type of the specified field in a result
- fbsql_field_flags() - Get the flags associated with the specified field in a result