CSVParser – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Die CSVParser Die API bietet Methoden zum Analysieren von CSV-formatierten Datensätzen (Comma Separated value) in einem Objekt oder Array.

    Diese API wird in ausgeführt sn_impex Namespace.

    CSVParser – parseLineToArray(Zeichenfolge cvsLine, Zeichenfolgentrennzeichen, Zeichenfolge quoteCharacter)

    Analysiert übergebene CSV-formatierte Inhalte an ein Array.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    CsvLine Zeichenfolge Zu analysierender CSV-Inhalt.
    Trennzeichen Zeichenfolge Optional. Zeichen, das zum Trennen der Felder im CSV-Quellinhalt verwendet wird.

    Standard: Komma „,“

    QuoteCharacter Zeichenfolge Optional. Zeichen, das als Anführungszeichen im CSV-Quellinhalt verwendet wird.

    Standard: Doppeltes Anführungszeichen „“

    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Array Array, das die analysierten Werte für jedes Element im übergebenen CSV-Inhalt enthält.

    Zum Beispiel:

    {
    Joe,
    Smith,
    470 W Carmen, Chicago IL, 60640
    }

    Dieses Beispiel zeigt einfache Inhalte im CSV-Format, die in einem zurückgegebenen Array analysiert werden.

    var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
    var delimiter = ',';
    var quoteCharacter = '"';
    
    var x = new sn_impex.CSVParser().parseLineToArray(csvLine, delimiter, quoteCharacter);
    
    gs.log(x[0]);
    gs.log(x[1]);
    gs.log(x[2]);
    

    Ausgabe:

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

    CSVParser – parseLineToObject(Zeichenfolge cvsLine, Array-Header, Zeichenfolgentrennzeichen, Zeichenfolge quoteCharacter)

    Analysiert übergebene CSV-formatierte Inhalte in ein Objekt.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    CsvLine Zeichenfolge Zu analysierender CSV-Inhalt.
    headers Array aus Zeichenfolgen Header, die dem CSV-Inhalt zugeordnet sind. Diese Header müssen in derselben Reihenfolge wie der entsprechende Inhalt in angegeben werden csvLine. Beispiel: VAR-Header = ['first_Name', 'Last_Name', 'address'];
    Trennzeichen Zeichenfolge Optional. Zeichen, das zum Trennen der Felder im CSV-Quellinhalt verwendet wird.

    Standard: Komma „,“

    QuoteCharacter Zeichenfolge Optional. Zeichen, das als Anführungszeichen im CSV-Quellinhalt verwendet wird.

    Standard: Doppeltes Anführungszeichen „“

    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Objekt Objekt, das den Header und den entsprechenden Wert für jedes Element im übergebenen CSV-Inhalt enthält.

    Zum Beispiel:

    {
    first_name: Joe,
    last_name: Smith,
    address: 1470 W Carmen, Chicago IL, 60640
    }

    Dieses Beispiel zeigt CSV-formatierten Inhalt, der in ein zurückgegebenes Objekt analysiert wird.

    var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
    var headers = ['first_name', 'last_name', 'address'];
    var delimiter = ',';
    var quoteCharacter = '"';
    
    var x = new sn_impex.CSVParser().parseLineToObject(csvLine, headers, delimiter, quoteCharacter);
    
    gs.log(x.first_name);
    gs.log(x.last_name);
    gs.log(x.address);
    

    Ausgabe:

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

    Dieses Beispiel zeigt eine Ausnahmeantwort aufgrund einer ungültigen Übergabe des Headerparameters.

    var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
    var headers = null;
    var delimiter = ',';
    var quoteCharacter = '"';
    try {
    var x = new sn_impex.CSVParser().parseLineToObject(csvLine, headers, delimiter, quoteCharacter);
    
    gs.log(x.first_name);
    gs.log(x.last_name);
    gs.log(x.address);
    }
    catch(ex) {
          gs.info(ex.message);
    }
    

    Ausgabe:

    CSVParser: Header list is empty: no thrown error
    *** Script: CSVParser: Header list is empty