$parser.load

Description

Crée une nouvelle instance de parseur.

Fermeture

L'instance de parseur créée ici DOIT être clôturée au moyen de la méthode $parser.close. Si un parseur n'est pas correctement fermé, le fichier ou le flux de donnée pourrait être verrouillé et rester modifiable.

Pour garantir que la fermeture soit bien effectuée, il est recommandé de placer la commande $parser.close dans une clause finally. Voir l'exemple donné plus bas.

Syntaxe

$parser.load( source , files [ , options ] )

Paramètres

source file / string

Objet à parser. Le paramètre peut désigner soit un objet file, soit une donnée de type string. Dans le second cas, c'est bien la valeur de la string elle-même qui est parsée.

options map

Map d'options. Les options reconnues sont:

charset string

Charset des données en entrée lorsque celle-ci est du type string. En l'absence de charset, la chaîne est interprétée en utf-8.

Retour

Retourne un objet pojo représentant l'instance de parseur qui pourra être référencé dans les autres méthodes de la librairie. Retourne null si l'instanciation du parseur a rencontré une erreur.

Exemple

var parser = $parser.load($file.load("C:/Temp/ch/eingang_entree_entrata.csv"));

try {
    var t, s = 0;
    while (true) {
        t = $parser.next(parser);
        if (s % 1000000 == 0) $logger.info("${s}: ${t}");
        ++s;
    }
} catch (e) {
    // fin de traitement
    $logger.warn(e);
} finally {
    $parser.close(parser);
}