CSVParser – Scoped
Die CSVParser -API stellt Methoden zum Analysieren von CSV-formatierten Datensätzen (Comma Separated Value) in einem Objekt oder Array bereit.
Diese API wird im Namespace sn_impex ausgeführt.
CSVParser – parseLineToArray(String cvsLine, String delimiter, String QuoteCharacter)
Analysiert in CSV-formatierten Inhalten übergebene Inhalte in einem Array.
| Name | Typ | Beschreibung |
|---|---|---|
| csvLine | Zeichenfolge | Zu analysierender CSV-Inhalt. |
| Trennzeichen | Zeichenfolge | Optional. Zeichen, das zum Begrenzen der Felder im CSV-Quellinhalt verwendet wird. Standard: Komma ',' |
| QuoteCharacter | Zeichenfolge | Optional. Zeichen, das im Quell-CSV-Inhalt als Anführungszeichen verwendet wird. Standard: Doppelte Anführungszeichen „“ |
| Typ | Beschreibung |
|---|---|
| Array | Array mit den analysierten Werten für jedes Element im übergebenen CSV-Inhalt. Beispiel: |
Dieses Beispiel zeigt einfachen CSV-formatierten Inhalt, der in ein zurückgegebenes Array analysiert wird.
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(String cvsLine, Array headers, String delimiter, String QuoteCharacter)
Analysiert in CSV-formatierten Inhalten übergebene 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 Kopfzeilen müssen in derselben Reihenfolge wie der entsprechende Inhalt in csvLineangegeben werden. Beispiel: var headers = ['first_name', 'last_name', 'address']; |
| Trennzeichen | Zeichenfolge | Optional. Zeichen, das zum Begrenzen der Felder im CSV-Quellinhalt verwendet wird. Standard: Komma ',' |
| QuoteCharacter | Zeichenfolge | Optional. Zeichen, das im Quell-CSV-Inhalt als Anführungszeichen verwendet wird. Standard: Doppelte Anführungszeichen „“ |
| Typ | Beschreibung |
|---|---|
| Objekt | Objekt, das die Kopfzeile und den entsprechenden Wert für jedes Element im übergebenen CSV-Inhalt enthält. 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 Header-Parameters.
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