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

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.
To Top