# RANGETOJSON

#### Syntax

**RANGETOJSON**(*values; keys*)

1. *values* - die Werte, die dem json-String hinzugefügt werden sollen - Wertetyp: beliebig 
2. keys - die Schlüssel-Werte, die dem json-String hinzugefügt werden - Wertetyp: Text (optional)

#### Bemerkungen

* Der json-String wird auf folgende Weise erstellt: 
  * Wenn *keys* angegeben ist, werden diese zusammen mit den *values* als Schlüssel-Wert-Paare auf folgende Weise in den json-String verpackt: 
    * Wenn *values* nur eine Zeile enthält, besteht der json-String aus einem Objekt, einschließlich der Schlüssel-Wert-Paare von *keys* und dem entsprechenden *values-*Wert. 
    * Wenn *values* mehrere Zeilen enthält, besteht der json-String aus einem Array mit einem Objekt pro Zeile, einschließlich der Schlüssel-Wert-Paare von *keys* und dem entsprechenden *value* (auf die gleiche Weise wie oben). 
  * Wenn *keys* nicht angegeben ist, werden *values* als Array-Elemente in den json-String gepackt, und zwar auf folgende Weise: 
    * jede Zeile von *values* wird als Element des Arrays hinzugefügt, 
    * wenn eine Zeile mehr als eine Zelle enthält, wird jeder Zellinhalt der Zeile als Element eines Unter-Arrays zum äußeren Array hinzugefügt.

#### Beispiele

**Beispiel 1** - Der Inhalt der Widgets *keys* und *values* wird verwendet, um den json-Text zu erstellen.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/LEedtNkScVLSl6QWox8Y/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 2 -** Dasselbe wie in Beispiel 1, aber das Widget #values enthält jetzt mehrere Zeilen. Jede Zeile wird dann als separates Objekt in den json-String eingefügt.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/fTiIVyfwMRRgu6gs1ekf/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 3**: Wenn keine *keys* angegeben werden, werden nur die *values* in den json-String eingefügt.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/p5uAWqxx9Jw9aWSUJmRD/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 4** - Diese Struktur kann verwendet werden, um einen json-String mit nur einem Array zu erstellen, das Werte enthält.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/DU7pOCYvpeyiSrGPXssR/grafik.png" alt=""><figcaption></figcaption></figure>

**Beispiel 5**: Wie in Beispiel 3, aber mit mehreren Zeilen in #values. Dies gibt dann einen json-String zurück, der ein verschachteltes Array von Werten enthält.

<figure><img src="https://content.gitbook.com/content/5AXM9De6LygFtEaDe5ri/blobs/9xbGvR37C8dqjumzhkeC/grafik.png" alt=""><figcaption></figcaption></figure>