Automation Engine Script-Leitfaden > Funktionelle Gliederung > Strings > ARRAY_2_STRING

ARRAY_2_STRING

Script-Funktion: Wandelt ein Script-Array in eine Zeichenkette um.

Syntax

ARRAY_2_STRING(Script Array, [Separator], [Area])

Syntax	Beschreibung/Format
Script-Array	Variablenname des Arrays. Format: Script-Variable
Trennzeichen	Ein oder mehrere Zeichen, die in der Zeichenkette zwischen den Array-Elementen eingefügt werden sollen. Format: Script-Variable oder Script-Literal
Bereich	Bereich des Arrays Erlaubte Werte: "ALL" oder "FILLED" (Standardwert) "ALL" = Alle Elemente des Arrays verwenden "FILLED" = Alle Elemente bis zum letzten befüllten Element speichern.

Syntax

Beschreibung/Format

Script-Array

Variablenname des Arrays.
Format: Script-Variable

Trennzeichen

Ein oder mehrere Zeichen, die in der Zeichenkette zwischen den Array-Elementen eingefügt werden sollen.
Format: Script-Variable oder Script-Literal

Bereich

Bereich des Arrays

Erlaubte Werte: "ALL" oder "FILLED" (Standardwert)

"ALL" = Alle Elemente des Arrays verwenden
"FILLED" = Alle Elemente bis zum letzten befüllten Element speichern.

Rückgabewerte
Zeichenkette, welche die Elemente des Arrays enthält.

Anmerkungen

Die Script-Funktion liefert die Elemente eines Script-Arrays in Form einer Zeichenkette zurück. Dabei ist der Variablenname des Arrays, inklusive der leeren Indexklammern [], anzugeben.

Zusätzlich können ein oder mehrere Trennzeichen festgelegt werden, welche die Elemente in der resultierenden Zeichenkette voneinander trennen.

Sie haben außerdem die Möglichkeit, zu bestimmen, ob alle Elemente oder nur jene bis zum letzten befüllten Element verwendet werden sollen. Im letzteren Fall werden leere Elemente am Ende des Arrays ignoriert.

Beispiele

In folgendem Beispiel-Script wird ein Array erstellt und mit Einträgen eines Variablen-Objektes befüllt. Anschließend wird das Array in eine Zeichenkette umgewandelt und diese im Aktivierungsreport ausgegeben. Als Trennzeichen für die Array-Elemente wird ein Bindestrich verwendet.

:DEFINE &ARRAY#, string, 5
:DEFINE &STR#, string
:FILL &ARRAY#[] = GET_VAR(VARA.STATIC.TEST,"KEY01")
:SET &STR# = ARRAY_2_STRING(&ARRAY#[],"-",FILLED)
:P "&STR#"

Siehe auch:

Script-Sprachmittel	Beschreibung
:CLEAR	Setzt ein Script-Array wieder auf seine Initialwerte zurück.
:DEFINE	Erstellung einer Script-Variable mit einem bestimmten Datentyp.

Script-Sprachmittel - Script-Aufbau und Prozessierung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support