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, если возникла ошибка.

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

Версия	Описание
PECL-модуль 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() - Получает запись из базы данных как индексный массив