mysql_list_fields

(PHP 3, PHP 4 )

mysql_list_fields -- List MySQL result fields

Description

int mysql_list_fields (string database_name, string table_name [, int link_identifier])

mysql_list_fields() retrieves information about the given tablename. Arguments are the database name and the table name. A result pointer is returned which can be used with mysql_field_flags(), mysql_field_len(), mysql_field_name(), and mysql_field_type().

A result identifier is a positive integer. The function returns -1 if a error occurs. A string describing the error will be placed in $phperrmsg, and unless the function was called as @mysql() then this error string will also be printed out.

Example 1. mysql_list_fields() example


$link = mysql_connect('localhost', 'myname', 'secret');

$fields = mysql_list_fields("database1", "table1", $link);
$columns = mysql_num_fields($fields);

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

The above example would produce the following output:


field1
field2
field3
...
      

For downward compatibility mysql_listfields() can also be used.