# 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-6a749e0d854b7c47049ed08816a255eee38f24ca%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-b192ce1f190266ee16b4054e7be04c502adcd001%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-a99705094a3b428bc1e8fde77d1a8eb62aade8e9%2Fgrafik%20(14).png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-013a0f1293e2d14cf5517c6a9d8c7e57c210919f%2Fgrafik.png?alt=media" 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://2811933300-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnqJ9EkNaXVzEBF0wgp7y%2Fuploads%2Fgit-blob-4b9d25e900e3e4231d4a1e378a62a8f15f831e09%2Fgrafik.png?alt=media" alt=""><figcaption></figcaption></figure>