4D v14.3

ARRAY STRING

Home

 
4D v14.3
ARRAY STRING

ARRAY STRING 


 

ARRAY STRING ( Länge ; ArrayName ; Größe {; Größe2} )  
Parameter Typ   Beschreibung
Länge  Lange Ganzzahl in Länge der Zeichenkette (1... 255)
ArrayName  Array in Name des Array
Größe  Lange Ganzzahl in Anzahl der Elemente im Array der Anzahl der Reihen, wenn Größe2 angegeben ist
Größe2  Lange Ganzzahl in Anzahl der Spalten in zweidimensionalem Array

Der Befehl ARRAY STRING erstellt und/oder passt ein Array mit Elementen vom Typ Alphanumerisch im Speicher an.

Hinweis zur Kompatibilität: Datenbanken, die mit 4D Version 11 erstellt werden, laufen standardmäßig im Unicode Modus (siehe Abschnitt ASCII Codes). In diesem Modus funktioniert ARRAY STRING genauso wie ARRAY TEXT (der Parameter Länge wird ignoriert. Wir empfehlen in neuen Entwicklungen, den Befehl ARRAY TEXT zu verwenden. Der Befehl ARRAY STRING wird nur zur Wahrung der Kompatibilität beibeihalten.

  • Der Parameter Länge legt die max. Anzahl von Zeichen fest, die pro Element in einem alphanumerischen Array enthalten sein können. Die Höchstzahl ist 255 Zeichen.
    Hinweis:
    Dieser Parameter wird nur berücksichtigt, wenn die Datenbank im Nicht-Unicode Modus läuft. Im Unicode Modus wird er ignoriert (siehe oben).
  • 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 STRING 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.

Dieses Beispiel erstellt ein Prozess-Array mit 100 31-Zeichen-langen Elementen vom Typ Alphanumerisch:

 ARRAY STRING(31;asValues;100)

Dieses Beispiel erstellt ein lokales Array mit 100 Reihen mit 50 63-Zeichen-langen Elementen vom Typ Alphanumerisch:

 ARRAY STRING(63;$asValues;100;50)

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

 ARRAY STRING(255;<>asValues;50)
 For($vlElem;1;50)
    <>asValues{$vlElem}:="Element #"+String($vlElem)
 End for

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Arrays
Nummer: 218

Dieser Befehl ist überholt und sollte nicht mehr verwendet werden.

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
SIEHE AUCH 

ARRAY TEXT

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)