DBASE_GET_HEADER_INFO(3)						 1						  DBASE_GET_HEADER_INFO(3)

dbase_get_header_info - Gets the header info of a database

SYNOPSIS

       array dbase_get_header_info (int  $dbase_identifier)

DESCRIPTION

	Returns information on the column structure of the given database link identifier.

PARAMETERS

	      o $dbase_identifier
		- The database link identifier, returned by dbase_open(3) or dbase_create(3).

RETURN VALUES

	An indexed array with an entry for each column in the database. The array index starts at 0.

	Each array element contains an associative array of column information, as described here:

	      o name
		- The name of the column

	      o type
		- The human-readable name for the dbase type of the column (i.e. date, boolean, etc.)

	      o length
		- The number of bytes this column can hold

	      o precision
		- The number of digits of decimal precision for the column

	      o format
		- A suggested printf(3) format specifier for the column

	      o offset
		- The byte offset of the column from the start of the row

	If the database header information cannot be read, FALSE is returned.

EXAMPLES

       Example #1

	      Showing header information for a dBase database file

	      <?php
	      // Path to dbase file
	      $db_path = "/tmp/test.dbf";

	      // Open dbase file
	      $dbh = dbase_open($db_path, 0)
		or die("Error! Could not open dbase database file '$db_path'.");

	      // Get column information
	      $column_info = dbase_get_header_info($dbh);

	      // Display information
	      print_r($column_info);
	      ?>

PHP Documentation Group 												  DBASE_GET_HEADER_INFO(3)