4D Doc Center : ARRAY TEXT

Home

4D v14.3

ARRAY TEXT


ARRAY TEXT ( ArrayName ; Größe {; Größe2} )

Parameter	Typ	Beschreibung
ArrayName	Array	Name des Array
Größe	Lange Ganzzahl	Anzahl der Elemente im Array oder Anzahl der Spalten, wenn Größe2 angegeben
Größe2	Lange Ganzzahl	Anzahl der Spalten in zweidimensionalem Array

Beschreibung

The Befehl ARRAY TEXT erstellt und/oder passt die Größe des Array mit Elementen vom Typ Text im Speicher an.

Der Parameter ArrayName ist der Name des Array.
Der Parameter Größe ist die Anzahl der Elemente im Array.
Der Parameter Größe2 ist optional; ist Größe2 angegeben, wird ein zweidimensionales Array erstellt. In diesem Fall gibt Größe die Anzahl der Reihen und Größe2 die Anzahl der Spalten in jedem Array an. In einem zweidimensionalen Array kann jede Reihe sowohl als Element als auch als Array behandelt werden. So können Sie, während Sie mit der ersten Dimension des Array arbeiten, mit anderen Befehlen ganze Arrays in einem zweidimensionalen Array einfügen oder löschen.

Wenden Sie ARRAY TEXT auf ein bestehendes Array an, gilt folgendes:

Erweitern Sie die Größe des Array, bleiben die vorhandenen Elemente unverändert, die neuen Elemente werden auf "" (leere Zeichenkette) initialisiert.
Verringern Sie die Größe des Array, gehen die letzten aus dem Array gelöschten Elemente verloren.

Beispiel 1

Dieses Beispiel erstellt ein Prozess-Array mit 100 Elementen vom Typ Text:

ARRAY TEXT(atValues;100)

Beispiel 2

Dieses Beispiel erstellt ein lokales Array mit 100 Reihen mit 50 Elementen vom Typ Text:

ARRAY TEXT($atValues;100;50)

Beispiel 3

Dieses Beispiel erstellt ein Interprozess-Array mit 50 Elementen vom Typ Text und setzt jedes Element auf den Wert “Element #” gefolgt von seiner Elementnummer:

 ARRAY TEXT(◊atValues;50)

 For($vlElem;1;50)

    ◊atValues{$vlElem}:="Element #"+String($vlElem)

 End for