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 $dbase_identifier , int $record_number ) : array

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

Liste de paramètres

dbase_identifier

L'identifiant du lien à la base de données, retourné par dbase_open() ou dbase_create().

record_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 dbase_identifier 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