Edit Report a Bug

    dbase_get_record_with_names

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

    dbase_get_record_with_names — Liefert einen Datensatz aus einer Datenbank als assoziatives Array

    Beschreibung

    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
    dbase 7.0.0 database ist nun eine resource statt eines 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

    add a note add a note

    User Contributed Notes 2 notes

    up
    2
    bishop
    19 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);
    }
    ?>
    up
    -1
    Anonymous
    19 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 add a note
    To Top