`$dbf.load`¶

Description¶

Charge le contenu d'un fichier DBF en mémoire sous forme d'un tableau de records. Le tableau est un array et chaque record est un map.

Syntaxe¶

$dbf.load( dbf [ , options ] )

Paramètres¶

dbf file / string

Fichier DBF à traiter

Le paramètre peut désigner un fichier ou un path.

options map

Map d'options. Les options reconnues sont:

format string

Format des records dans la valeur de sortie. Les formats supportés sont map ou array. Le format par défaut est map.

Pour rappel, l'ordre des éléments dans l'array reprend l'ordre des colonnes du DBF, alors que l'ordre des entrées du map n'est pas garanti.

rowfilter map

Filtre de record. Lorsqu'un filtre est défini, le moteur ne reprend dans la réponse que les records dont les valeurs correspondent aux éléments du map. Le moteur effectue un test d'égalité stricte entre la valeur inscrite dans le filtre et la valeur du record.

colfilter array / string / number

Filtre de colonne. Seules les colonnes mentionnées dans le filtre sont reprises dans la sortie. Il est possible de désigner une colonne avec son nom ou sa position (0-based).

Retour¶

Tableau de records dont le type dépend du format défini dans les options.

Exemple¶

var data = $dbf.load("C:/Temp/dbase_03.dbf", {
    rowfilter: { Data_Dicti: "MS4", GPS_Week: 1331 },
    colfilter: [ "GPS_Date", "Data_Dicti", "GPS_Week" ],
    format: "array"
});
$logger.info($json.toJson(data));

$dbf.load¶