Gibt eine strukturierte Liste oder ein Array von Zeilen und Daten aus dem angegebenen CSV-Text zurück

Die Funktion parseCSV liest CSV-formatierten Text aus und gibt ihn als strukturierte Liste oder Array zurück. Sie können das Ausleseprozess anpassen, indem Sie Kopfzeilen, Trennzeichen und Text-Anführungszeichen festlegen.

Syntax

parseCSV(string, json)

Parameter

• data (string): Der Eingabetext im CSV-Format. Beispiel: "Name,Alter\nKiran,42\nLisa,27"
• options (JSON-Objekt): Optionale Konfiguration mit folgenden Eigenschaften:
  • firstLineIsHeader: boolean, Standardwert ist false. Wenn true, wird die erste Zeile als Spaltenüberschrift behandelt.
  • separator: string. Legt das Trennzeichen zwischen den Feldern fest, z. B. "," oder ";". Wird automatisch erkannt, wenn es nicht angegeben ist.
  • textQuote: string. Gibt das Zeichen an, das zum Anführen von Textfeldern verwendet wird. Standard ist " (doppelte Anführungszeichen).

Rückgabewert

JSON: Eine Liste oder ein Array von JSON-Objekten, mit Schlüsseln aus der Kopfzeile, wenn firstLineIsHeader true ist.

[text]: Eine Liste oder ein Array von Text-Arrays (Zeilen), wenn firstLineIsHeader false ist.

Beispiele

1. Standard firstLineIsHeader=false

Beispiel:

parseCSV("Name,Alter
Kiran,42
Lisa,27", {})

Oder setzen Sie firstLineIsHeader ausdrücklich auf false:

parseCSV("Name,Alter
Kiran,42
Lisa,27", {firstLineIsHeader: false})

Ergebnis:

[
  ["Name", "Alter"],
  ["Kiran", "42"],
  ["Lisa", "27"]
]

2. Verwendung von firstLineIsHeader=true

Beispiel:

parseCSV("Name,Alter
Kiran,42
Lisa,27", {firstLineIsHeader: true})

Ergebnis:

[
  {
    Name: "Kiran",
    Alter: "42"
  },
  {
    Name: "Lisa",
    Alter: "27"
  },
]

3. Benutzerdefiniertes Trennzeichen

Hinweis: Wenn kein separator angegeben ist, erkennt parseCSV automatisch ein gängiges Trennzeichen wie Kommas oder Tabs basierend auf der Eingabestruktur.

Beispiel:

parseCSV("Name;Alter
Kiran;42
Lisa;27", {separator: ";", firstLineIsHeader: true})

Ergebnis:

[
  {
    Name: "Kiran",
    Alter: "42"
  },
  {
    Name: "Lisa",
    Alter: "27"
  },
]

4. Angabe von textQuote

Hinweis: Verwenden Sie textQuote, um ein Zeichen für das Anführen von Feldern anzugeben. Es ist nicht erforderlich, jedes Feld zu kennzeichnen; parseCSV liest unmarkierte Felder trotzdem korrekt.

In diesem Beispiel sind die Textfelder mit einfachen Anführungszeichen markiert.

Beispiel:

parseCSV("Name,Alter
Kiran,42
'Lisa',27", {firstLineIsHeader: true})

Ergebnis:

[
  {
    Name: "Kiran",
    Alter: "42"
  },
  {
    Name: "'Lisa'",
    Alter: "27"
  },
]

5. Verwendung eines benutzerdefinierten textQuote-Zeichens

Sie können ein textQuote-Zeichen, wie ein einfaches Anführungszeichen ('), festlegen, um Felder mit zitierten Texten spezifisch zu behandeln.

Beispiel:

parseCSV("Name,Alter
Kiran,42
'Lisa',27", {textQuote: "'", firstLineIsHeader: true})

Ergebnis:

[
  {
    Name: "Kiran",
    Alter: "42"
  },
  {
    Name: "Lisa",
    Alter: "27"
  },
]