# 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2Ffdz1qwZK1hM2gqI3PeNu%2Fgrafik.png?alt=media&#x26;token=d6ed1566-2ab7-49e3-860e-8fecd16c203d" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FStV0kcl53pONEFPkzGbz%2Fgrafik.png?alt=media&#x26;token=fe993654-f549-4021-8c68-d97070f45b89" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FbJDG5kBEe7WRIsy2msWw%2Fgrafik.png?alt=media&#x26;token=29b46eb2-49a5-4cd3-b07f-f08bcf55b94e" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2F1Rrzr29G4xENZNNEWPxE%2Fgrafik.png?alt=media&#x26;token=f040a86d-e602-4efa-b8bb-214d73e151ff" 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://2998357603-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUHij42nMV8tut4oUjbNm%2Fuploads%2FdgSclaV4k6hfND47J7Hv%2Fgrafik.png?alt=media&#x26;token=3e0ff8b2-f0d4-4561-9b4c-bd77474350db" alt=""><figcaption></figcaption></figure>