Recherche un ou plusieurs éléments de liste dans une liste nommée.
Syntaxe
SearchListElements(List, ElementName, [ IgnoreCase = TRUE ] [ , ElementNameType = ELEMENTNAMETYPE_NAME ])
La syntaxe de la fonction SearchListElements se compose des éléments suivants :
Section |
Description |
||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
List |
Une liste dans laquelle rechercher des éléments. Les structures de données autorisées sont Liste. Tous les types de données sont autorisés. |
||||||||||
ElementName |
Une valeur individuelle ou une série de données avec les noms à rechercher. Il est également possible d'indiquer des caractères "joker" '?' ou '*'. Ensuite, une comparaison des échantillons est effectuée. Dans ce cas, le caractère * représente toute chaîne de caractères et peut également être vide. ? représente tout caractère. Les structures de données autorisées sont Scalaire et Série de données. Les types de données pris en charge sont Chaîne de caractères. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||
IgnoreCase |
Une valeur booléenne qui indique s'il faut ignorer la casse lors d'une recherche. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut TRUE . |
||||||||||
ElementNameType |
Détermine la manière dont les noms des éléments de la liste de résultats sont générés. L'argument ElementNameType peut avoir les valeurs suivantes :
Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut ELEMENTNAMETYPE_NAME . |
Remarques
Si un élément de la liste n'a pas de nom, il est ignoré. La recherche ne porte que sur les éléments de la liste qui ne contiennent pas eux-mêmes d'éléments, c'est-à-dire sur les feuilles d'une liste lorsqu'elle est considérée comme un arbre. Tous les éléments de la liste dont le nom d'élément correspond au critère de recherche sont repris dans la liste de résultats dans un ordre inchangé.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
SearchListElements([<a>1, <b>2], "a") |
Renvoie [<a>1]. Le résultat est une liste avec un élément 'a'. |