Edit Report a Bug

dbase_get_record_with_names

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

dbase_get_record_with_names — Получает запись из базы данных в виде ассоциативного массива

Описание

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

Получает запись из базы данных dBase в виде ассоциативного массива (вместе с именами соответствующих полей).

Список параметров

database: Ресурс базы данных, возвращаемый функцией dbase_open() или dbase_create().
number: Индекс записи (здесь соответствует физическому номеру записи. — прим. перев.) в диапазоне от 1 до dbase_numrecords($dbase_identifier)

Возвращаемые значения

Ассоциативный массив с данными строки. Массив будет содержать ключ deleted, который равен 1, если запись помечена на удаление (смотрите описание функции dbase_delete_record()). Возвращает и пустые записи. Поэтому этой функцией невозможно извлечь значение или имя поля delete.

Каждое поле преобразовывается в соответствующий тип PHP, за исключением:

Объект Date преобразовывается в строку.
Объект DateTime преобразовывается в строку.
Целые, выходящие из диапазона PHP_INT_MIN..PHP_INT_MAX, преобразовываются в строки.
До dbase 7.0.0 логические значение (L) преобразовываются в 1 или 0.

В случае возникновения ошибки функция dbase_get_record_with_names() возвращает false.

Список изменений

Версия	Описание
dbase 7.0.0	Параметр `database` теперь имеет тип resource, а не int.

Примеры

Пример #1 Список всех зарегистрированных пользователей в базе данных

<?php
// открываем базу в режиме чтения
$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";
      }
  }
}
// Прим. пер. -
// к полученным с помощью dbase_get_record_with_names значениям записи
// обращаемся по имени - $row['ismember'],
// а в случае с dbase_get_record к значениям записи
// обращаемся по номеру - $row[4]
?>

Смотрите также

dbase_get_record() - Получает записи из базы данных, как из индексированного массива

add a note

User Contributed Notes 2 notes

down

bishop ¶

18 years ago


I would like to emphasize that record numbers begin with 1, not 0. So, this is wrong:
<?php
$recCnt = dbase_numrecords($fh);
for ($recNum = 0; $recNum < $recCnt; $recNum++) {
    // wrong! first record will fail
    $record = dbase_get_record_with_names($fh, $recNum);
}
?>

This is right:

<?php
$recCnt = dbase_numrecords($fh);
for ($recNum = 1; $recNum <= $recCnt; $recNum++) {
    // right! record #s begin with 1, don't forget <=
    $record = dbase_get_record_with_names($fh, $recNum);
}
?>

down

-1

Anonymous ¶

18 years ago


$foo_db = dbase_open ( 'foo.dbf', 0);

if ($foo_db) {
  $rn = dbase_numrecords($foo_db);

  echo "Record 0: ";
  $test = dbase_get_record_with_names($foo_db, 0);
  echo $test['deleted'] . " FOO BAR: '" . $test['BAR'] . "'\n";

  echo "Record n+1: ";
  $test = dbase_get_record_with_names($foo_db, $rn+1);
  echo $test['deleted'] . " FOO BAR: '" . $test['BAR'] . "'\n";

}

Gives: 

Record 0: 0 FOO BAR: ' '

Record n+1:
Warning: Tried to read bad record 30 in ./DisplayAccounts.php on line 21
FOO BAR: ''

0 is not an error record, it's just empty - and actually, not quite empty, as you see BAR got a single space.

add a note