Créer des tableaux

4D v20 R7

Créer des tableaux

Vous créez un tableau au moyen de l'une des commandes de déclaration de tableau décrites dans ce chapitre. Voici la liste des commandes de déclaration de tableau :

Commande	Crée ou redimensionne un tableau de :
ARRAY INTEGER	Entiers (sur 2 octets)
ARRAY LONGINT	Entiers (sur 4 octets)
ARRAY REAL	Réels
ARRAY TEXT	Textes (jusqu'à 2 Go de texte par élément)*
_o_ARRAY STRING	Textes (obsolète)*
ARRAY DATE	Dates
ARRAY BOOLEAN	Booléens
ARRAY PICTURE	Images
ARRAY POINTER	Pointeurs
ARRAY OBJECT	Objets de langage
ARRAY BLOB	BLOBs
ARRAY TIME	Heures

Chaque commande de déclaration de tableau peut créer ou redimensionner des tableaux à une ou à deux dimensions. Pour plus d'informations sur les tableaux à deux dimensions, reportez-vous à la section Tableaux à deux dimensions.

(*) Il n'y a aucune différence entre les tableaux Texte et les tableaux Alpha. Le paramètre longueurChaîne de la commande _o_ARRAY STRING est ignoré. Il est conseillé d'utiliser des tableaux Texte. La commande _o_ARRAY STRING est conservée pour des raisons de compatibilité uniquement.

Cette ligne de code crée (déclare) un tableau d'entiers de 10 éléments :

ARRAY INTEGER(aiUnTableau;10)

Ensuite, cette ligne de code redimensionne le même tableau à 20 éléments :

ARRAY INTEGER(aiUnTableau;20)

Enfin, cette ligne de code redimensionne le même tableau à 0 élément :

ARRAY INTEGER(aiUnTableau;0)

Vous référencez les éléments d'un tableau en utilisant des accolades ({…} ). Un nombre entre accolades donne accès à l'adresse d'un élément particulier. Ce nombre est appelé numéro de l'élément. L'exemple ci-dessous place cinq noms dans le tableau nommé atNoms et les affiche ensuite dans une fenêtre d'alerte :

 ARRAY TEXT(atNoms;5)

 atNoms{1}:="Richard"

 atNoms{2}:="Sarah"

 atNoms{3}:="Pierre"

 atNoms{4}:="Martine"

 atNoms{5}:="Jean"

 For($vlElem;1;5)

    ALERT("L'élément #"+String($vlElem)+" est égal à: "+atNoms{$vlElem})

 End for

Notez la syntaxe atNoms{$vlElem}. Au lieu de spécifier un nombre littéral comme atNoms{3}, vous pouvez utiliser une variable numérique indiquant à quel élément d'un tableau vous accédez.

Si vous utilisez les itérations permises par les structures répétitives (ARRAY TO LIST, LIST TO ARRAY ou PLAY), vous pouvez accéder à tout ou partie des éléments d'un tableau avec très peu de code.

Les tableaux et les autres commandes du langage 4D

Il existe d'autres commandes 4D qui permettent de créer ou de manipuler des tableaux. En particulier :

Pour travailler avec des tableaux et des sélections d'enregistrements, utilisez les commandes SELECTION RANGE TO ARRAY, SELECTION TO ARRAY, ARRAY TO SELECTION et DISTINCT VALUES.
Les objets de type List box sont basés sur les tableaux ; plusieurs des commandes du thème “List box” manipulent des tableaux, par exemple LISTBOX INSERT ROWS.
Vous pouvez créer des graphes à partir de valeurs stockées dans des tables et des tableaux. Pour plus d'informations, reportez-vous à la commande GRAPH.
Les commandes LIST TO ARRAY et ARRAY TO LIST.
De nombreuses commandes peuvent construire des tableaux en un appel, par exemple FONT LIST, WINDOW LIST, VOLUME LIST, FOLDER LIST, DOCUMENT LIST, GET SERIAL PORT MAPPING, SAX GET XML ELEMENT, etc.

Voir aussi

_o_ARRAY STRING
ARRAY BLOB
ARRAY BOOLEAN
ARRAY DATE
ARRAY INTEGER
ARRAY LONGINT
ARRAY OBJECT
ARRAY PICTURE
ARRAY POINTER
ARRAY REAL
ARRAY TEXT
ARRAY TIME
Présentation des tableaux
Tableaux à deux dimensions