dbase_get_record

(PHP 5 < 5.3.0, dbase 5, dbase 7)

dbase_get_record Gets a record from a database as an indexed array

Description

dbase_get_record(resource $database, int $number): array

Gets a record from a database as an indexed array.

Parameters

database

The database resource, returned by dbase_open() or dbase_create().

number

The index of the record between 1 and dbase_numrecords($dbase_identifier).

Return Values

An indexed array with the record. This array will also include an associative key named deleted which is set to 1 if the record has been marked for deletion (see dbase_delete_record()).

Each field is converted to the appropriate PHP type, except:

  • Dates are left as strings.
  • DateTime values are converted to strings.
  • Integers outside the range PHP_INT_MIN..PHP_INT_MAX are returned as strings.
  • Before dbase 7.0.0, booleans (L) were converted to 1 or 0.

On error, dbase_get_record() will return false.

Changelog

Version Description
dbase 7.0.0 database is now a resource instead of an int.

See Also

add a note add a note

User Contributed Notes 1 note

up
1
webtestjira at nospam dot mytrashmail dot com
18 years ago
Nowhere in the documentaiont explains that if the entire DBF file is lacking a record for one whole column, you will not get a blank entry in your result from dbase_get_record().  You must use dbase_get_record_with_names(), it is the only safe way to read dbase files in PHP 4.

For example, if you have a dbase file with 12 columns, but 3 of them contain no data in any record, then your array returned from dbase_get_record() will only have 9 sequential array keys and values, leaving you no way to figure out which are the missing columns.
To Top