CSVParser – Umfang
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.
| 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 „“ |
| Typ | Beschreibung |
|---|---|
| Array | Array, das die analysierten Werte für jedes Element im übergebenen CSV-Inhalt enthält. Zum Beispiel: |
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.
| 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 „“ |
| Typ | Beschreibung |
|---|---|
| Objekt | Objekt, das den Header und den entsprechenden Wert für jedes Element im übergebenen CSV-Inhalt enthält. Zum Beispiel: |
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