Edit Report a Bug

dbase_get_record_with_names

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

dbase_get_record_with_names — Lit un enregistrement dans une base dBase, sous la forme d'un tableau associatif

Description

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

Récupère un enregistrement d'une base de donnée dBase en tant qu'un tableau associatif.

Liste de paramètres

database: La ressource de base de données, retournée par dbase_open() ou dbase_create().
number: L'index de l'enregistrement entre 1 et dbase_numrecords($dbase_identifier).

Valeurs de retour

L'enregistrement, sous la forme d'un tableau associatif. Ceci inclut également une clé nommée deleted qui est définie à 1 si l'enregistrement a été marqué pour effacement (voir la fonction dbase_delete_record()). Par conséquent il n'est pas possible de récupérer la valeur d'un champ nommé deleted avec cette fonction.

Chaque champs est converti en type PHP approprié, sauf :

Les dates sont conservées comme chaînes de caractères.
Les valeurs DateTime sont converties en chaînes de caractères.
Les entiers en dehors de l'intervalle PHP_INT_MIN..PHP_INT_MAX sont retournés comme chaînes de caractères.
Avant dbase 7.0.0, les booléens (L) étaient convertis en 1 ou 0.

En cas d'erreur, dbase_get_record_with_names() retourne false.

Historique

Version	Description
dbase 7.0.0	`database` est maintenant une resource au lieu d'un int.

Exemples

Exemple #1 Liste tous les membres enregistrés dans la base de données

<?php
// Ouverture en mode lecture seul
$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 "Membre #$i: " . trim($row['name']) . "\n";
    }
  }
}
?>

Voir aussi

dbase_get_record() - Lit un enregistrement dans une base dBase

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