Liefert einen Datensatz aus einer Datenbank als assoziatives Array

Beschreibung

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

Gibt einen Datensatz aus einer dBase-Datenbank als assoziatives Array zurück.

Parameter-Liste

database: Die Datenbank-Ressource, die von dbase_open() oder dbase_create() zurückgegeben wurde.
number: Der Index des Datensatzes zwischen 1 und dbase_numrecords($dbase_identifier).

Rückgabewerte

Ein assoziatives Array mit dem Datensatz. Dieses Array enthält einen zusätzlichen Schlüssel namens deleted, der auf 1 gesetzt ist, wenn der Datensatz zum Löschen markiert wurde (siehe dbase_delete_record()). Daher ist es nicht möglich den Wert eines Feldes mit dem Namen deleted mit dieser Funktion zu ermitteln.

Jedes Feld wird in den entsprechenden PHP-Typ umgewandelt, ausgenommen:

Datumsfelder werden als Zeichenkette zurückgegeben.
Zeitstempelwerte werden in Zeichenketten umgewandelt.
Ganzzahlen außerhalb des Bereiches PHP_INT_MIN..PHP_INT_MAX werden als Zeichenkette zurückgegeben.
Boolesche Werte (L) werden zu 1 oder 0 umgewandelt.

Falls ein Fehler auftritt, gibt dbase_get_record_with_names() false zurück.

Changelog

Version	Beschreibung
PECL dbase 7.0.0	`database` ist nun vom Typ resource statt int.

Beispiele

Beispiel #1 Liste aller in der Datenbank eingetragener Mitglieder

<?php
// im nur-lesen-Modus öffnen
$db = dbase_open('/tmp/test.dbf', 0);

if ($db) {
  $anzahl_datensaetze = dbase_numrecords($db);
  for ($i = 1; $i <= $anzahl_datensaetze; $i++) {
      $datensatz = dbase_get_record_with_names($db, $i);
      if ($datensatz['IstMitglied'] == 1) {
          echo "Mitglied #$i: " . trim($datensatz['Name']) . "\n";
      }
  }
}
?>

Siehe auch

dbase_get_record() - Liefert einen Datensatz aus einer Datenbank als indiziertes Array