# RANGETOCSV

#### Syntax

**RANGETOCSV**(*range*; *columnDelimiter*; *rowDelimiter*; *option*)

* *range* - der Bereich, der in einen csv-Text umgewandelt werden soll - ***Wertetyp**:* Bereich mit Zellen des Wertetyps "Text"
* *columnDelimiter* - das Zeichen, das die Zellenwerte spaltenweise trennt - ***Wertetyp**: Text (optional, Standardwert: “;”)*
* *rowDelimiter* - das Zeichen, das die Zellenwerte zeilenweise trennt - ***Wertetyp**: Text (optional, Standardwert: empty)*
* *option* - gibt an, ob Begrenzungszeichen in den Zellenwerten umgewandelt werden sollen - ***Wertetyp**: Konstante (optional, Standardwert: <mark style="color:red;">noescaping</mark>)*\
  Mögliche Werte sind:
  1. *<mark style="color:red;">noescaping</mark>* - Begrenzungszeichen in Zellenwerten werden nicht umgewandelt
  2. *<mark style="color:red;">escaping</mark>* - Begrenzungszeichen in Zellenwerten werden umgewandelt (siehe Bemerkungen)

#### Bemerkungen

1. *rowDelimiter* kann leer sein, dann werden nur die einzelnen Zeilen des Bereichs zu einem Spaltenbereich verkettet.
2. Um Sonderzeichen wie Tabulator, Return oder Zeilenvorschub anzuwenden, kann die Funktion CHAR für die Begrenzungszeichen verwendet werden (siehe Beispiel unten).
3. Wenn *option* den Wert <mark style="color:red;">escaping</mark> hat, werden die Begrenzungszeichen auf folgende Weise umgewandelt:
   1. es werden alle doppelten Anführungszeichen aller Texte im Bereich automatisch durch zwei doppelte Anführungszeichen ersetzt.
   2. wenn ein Zellwert eines der beiden Begrenzungszeichen oder ein Anführungszeichen enthält, wird der Zellwert automatisch in doppelte Anführungszeichen gesetzt.

#### Beispiele

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/h6N9RSFQxiYyXU7jz6Ce/grafik.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/fhXaDmFJwsP5tY5z6erd/grafik.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/UHij42nMV8tut4oUjbNm/blobs/VRueqpXCtgtbRhIqfQ7Z/grafik.png" alt=""><figcaption></figcaption></figure>