-
Introduction
Les structures sont des constructions complexes qui permettent de sauvegarder des données et les indexées en utilisant des clés (chaîne alphanumérique).
Les données peuvent être de n'importe quel type, y compris les types simples, les listes, les tableaux, les structures, …
-
Utiliser les structures
- En utilisant la syntaxe CFML :
- En utilisant le tag CFScript :
-
Accéder aux éléments d'une structure
- En utilisant la syntaxe CFML :
- En utilisant le tag CFScript :
Notes :
-
ColdFusion affiche une erreur si l'indice spécifié pour la structure n'existe pas.
Par exemple, si on essaye d'accéder au contenu de l'élément bookNumber
de la structure myStruct
on obtiendra l'erreur suivante :
« Element bookNumber is undefined in a CFML structure referenced as part of an expression. ».
-
Créer des structures implicites
Au lieu d'utiliser la méthode « structNew() », il est possible
d'utiliser les accolades « { » et « } » pour créer des
structures :
L'exemple précédent correspond à écrire :
Il est possible aussi de créer une structure et
lui assigner au même temps des valeurs. Dans l'exemple suivant on crée une
structure avec des valeurs par défaut :
Remarque :
Il est plus pratique d'utiliser la syntaxe implicite principalement dans les cas où on n'a pas besoin de déclarer explicitement une variable structure ; par exemple lors de l'appel d'une fonction.
Exemple :
Résultat d'exécution du code :
-
Fonctions pour manipuler les structures
-
StructNew
-
IsStruct
-
StructCopy
-
StructGet
-
StructAppend
-
StructInsert
-
StructUpdate
-
StructDelete
-
StructClear
-
StructFind
-
StructFindKey
-
StructFindValue
-
StructCount
-
StructIsEmpty
-
StructKeyArray
-
StructKeyExists
-
StructKeyList
-
StructSort
-
Duplicate