Fonctions de tableau
Cette section contient de brèves descriptions des fonctions qui renvoient des informations sur un tableau spécifique.
Fonction | Action |
---|---|
arraytostring | Renvoie une chaîne sur la base de données de tableau fournies, d'un modèle de départ, d'un modèle de fin et d'un séparateur. |
elementcount | Renvoie le nombre d'éléments non nuls ou non vides présents dans un tableau. |
nextelement | Renvoie l'entrée suivante non vide et non nulle, ou zéro s'il n'en existe pas, sur la base d'une zone de tableau et d'un index fournis. |
elementcount
Renvoie le nombre (entier) d'éléments non nuls ou non vides contenus
dans le tableau. Notez que la fonction
sizeof (<array_field>) renvoie la taille actuelle du tableau mais que certains éléments peuvent être des entrées nulles ou vides dans le tableau. Pour les tableaux de pièces jointes, une pièce jointe vide est considérée comme une entrée vide.
elementcount(array_field)
où array_field
représente la zone de données qui contient les données source.Exemples :
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100 , , 0) => elementcount(B) = 4; sizeof (B) = 6
Notez qu'une chaîne vide n'est pas comptée dans les tableaux de chaînes alors que chaque nombre est compté dans les tableaux numériques. Autrement dit, les nombres vides n'existent pas.
Cette fonction permet de gérer les tableaux de pièces jointes et de participants.
nextelement
La fonction renvoie l'entrée suivante non vide et non nulle, ou zéro s'il n'en existe pas, sur la base d'une zone de tableau et d'un index fournis. Si l'expression de type nombre entier est égale à zéro, elle renvoie le premier élément non vide non nul.
nextelement(array_field, index_expr)
où :Paramètre | Description |
---|---|
array_field | Représente la zone de données qui contient les données source. |
index_expr | Index à utiliser pour démarrer la recherche. Si l'index est égal à zéro, la recherche commence au début du tableau. |
Par exemple, avec les tableaux suivants :
A = ("", , "", "alpha",,"") B =(0 , , 0 , 100 , , 0)
nextelement (A, 0) = 4
nextelement (A, 4) = 0
nextelement (B, 0) = 1
nextelement (B, 1) = 3
nextelement (B, 3) = 4
nextelement (B, 4) = 6
nextelement (B, 6) = 0
Remarque : Les index de tableau Process commencent à
un mais l'index zéro est utilisé pour rechercher le premier élément non vide et non nul.
Cette fonction permet de gérer les tableaux de pièces jointes et de participants.
arraytostring
Cette fonction convertit des données de tableau en une chaîne.
arraytostring(array_field, begin_expr, end_expr, separator_expr)
où :Paramètre | Description |
---|---|
array_field | Représente la zone de données qui contient les données source. |
begin_expr | Chaîne texte qui marque le début du tableau |
end_expr | Chaîne texte qui marque la fin du tableau |
separator_expr | Chaîne texte utilisée pour séparer les éléments dans le tableau |
Par exemple, pour la zone de données MyStringArray contenant {1,2,3}, vous pouvez entrer la commande suivante pour renvoyer des données de chaîne :
- arraytostring(MyStringArray, "{ ", " }", ",") renvoie { 1,2,3 }
Vous pouvez utiliser cette fonction pour renvoyer une chaîne à partir d'un tableau de zone de données dans un schéma XML dans MyXMLField.
arraytostring(MyXMLField, ("<tag><value>", "</value></tag>", "</value><value>")
