PHP 8.4.0 RC4 available for testing

dba_firstkey

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_firstkeyИзвлекает первый ключ

Описание

dba_firstkey(Dba\Connection $dba): string|false

dba_firstkey() возвращает первый ключ из базы данных и сбрасывает внутренний указатель. Это позволяет производить прямой поиск по всей базе.

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

dba

Экземпляр класса Dba\Connection, который возвращают функции dba_open() и dba_popen().

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

Возвращает ключ в случае успешного выполнения или false, если возникла ошибка.

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

Версия Описание
8.4.0 Параметр dba теперь ожидает экземпляр класса Dba\Connection; раньше параметр ждал ресурс (resource) dba .

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

  • dba_nextkey() - Извлекает следующий ключ
  • dba_key_split() - Разделяет ключ, заданный в виде строки, и создаёт массив из полученных частей
  • Второй пример в примерах DBA

Добавить

Примечания пользователей 3 notes

up
0
jacky dot jackyhung dot net
22 years ago
for ($key = dba_firstkey($this->handle); $key !== false; $key = dba_nextkey($this->handle)) {
$keyset[] = $key;
} // end for
up
-1
rcracer91 at gmail dot com
15 years ago
I wondered why it wasn't already written, so I did because I think working with associative arrays is always as comfortable as can be

<?php
function dba_fetch_assoc($handle) {
$assoc = array();
for(
$k = dba_firstkey($handle); $k != false; $k = dba_nextkey($handle)) {
$assoc[$k] = dba_fetch($k, $handle);
}
return
$assoc;
}
?>
up
-1
psycho-logic at excite dot com
21 years ago
Looks like Jacky is using some DB object? I don't know if it's native to PHP or written on it's own... Anyways this is what I use:

$DBCon = dba_open("/tmp/test_db.db2", "r", "db2") or die("Uh oh, can't open the database :(");
if ($the_key = dba_firstkey($DBCon)) do {
print("Key: $the_key Value:");
print dba_fetch($the_key, $DBCon);
print("<BR>");
} while ($the_key = dba_nextkey($DBCon));
print ("<BR><BR><BR>Well looks like we're done here :-)");
To Top