dbase_get_record_with_names

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

dbase_get_record_with_names — Gets a record from a database as an associative array

Description

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

Gets a record from a dBase database as an associative 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 associative array with the record. This will also include a key named deleted which is set to 1 if the record has been marked for deletion (see dbase_delete_record()). Therefore it is not possible to retrieve the value of a field named deleted with this function.

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_with_names() will return false.

Changelog

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

Examples

Example #1 Listing all the registered members in the database

<?php
/ open in read-only mode
$db = dbase_open('/tmp/test.dbf', 0);

if ($db) {
  $record_numbers = dbase_numrecords($db);
  for ($i = 1; $i <= $record_numbers; $i++) {
      $row = dbase_get_record_with_names($db, $i);
      if ($row['ismember'] == 1) {
          echo "Member #$i: " . trim($row['name']) . "\n";
      }
  }
}
?>

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.