Collect Items Of. Syntaxe. Paramètres. La commande Collect Items Of fait partie du complément de pilotage Akua Sweets Akua List Sweets V 1.15.

Transcription

1 Collect Items Of La commande Collect Items Of fait partie du complément de pilotage Akua Sweets Akua List Sweets V La commande Collect Items Of permet d obtenir dans une liste de chaînes de caractères, le numéro des éléments qui correspondent à une expression, et les éléments eux-mêmes si le paramètre item contents est réglé à true. Syntaxe collect items of listofstring that match stringtosearch [ in position integer ] [ in subfield anything ] [ in user property stringproperty ] [ from point ] [ item contents booleanitem ] [ just contents booleanjust ] [ negation booleannegation ] [ expression evaluation booleanevaluation ] Paramètres listofstring stringtosearch integer Une liste de chaînes de caractères dans laquelle la recherche s effectue. Classe : List La chaîne de caractères ou une liste de chaînes à rechercher (voir Notes ). Classe : List Un nombre entier étendant la recherche aux éléments des souslistes de la liste, s il y en a, mais ces éléments doivent avoir le même numéro que le nombre entier spécifié (voir Exemples ). Classe : Integer anything stringproperty point La propriété d un enregistrement retourné par une commande (comme la commande Info For) (voir Exemples ). Classe : n importe La propriété d un enregistrement défini par l utilisateur (voir Exemples ). Classe : String Une liste de deux nombres entiers, le premier indique à quel numéro la recherche commence, le second indique à quel numéro la recherche s arrête (voir Exemples ). Par défaut, la valeur est {1,-1}. Classe : List of Integers Nicolas Descombes 05/ /5

2 booleanitem booleanjust booleannegation booleanevaluation commande Collect Items Of retournera une liste telle que {{numéro de l élément,data élément}...}. Si elle vaut false ou si le paramètre item contents est omis, la commande Collect Items Of retournera uniquement le numéro de l élément. commande Collect Items Of retournera les données. Si elle vaut false ou si le paramètre just contents est omis, la commande Collect Items Of retournera uniquement le numéro de l élément. commande Collect Items Of retournera les éléments qui ne correspondent pas aux critères. Si elle vaut false ou si le paramètre negation est omis, la commande Collect Items Of retournera uniquement les éléments qui correspondent aux critères. Une expression qui vaut true ou false (voir Notes ). Résultats Le numéro des éléments remplissant les critères, sous forme d une liste, ou plus suivant les options choisis. Exemples collect items of x that match "maison" collect items of x that match "maison" collect items of x that match "maison" just contents true -- résultat : {"maison"} collect items of x that match "maison" negation true -- résultat : {2,3} collect items of x that match "maison" negation true Nicolas Descombes 05/ /5

3 -- résultat : {{2,"demande"},{3,"prima"}} collect items of x that match "maison" from {1,-2} collect items of x that match "maison" from {2,-2} set y to {"maison","demande",{"demande","maison"}} collect items of y that match "maison" in position 3 collect items of y that match "maison" in position 2 -- résultat : {{1,"maison"},{3,{"demande","maison"}}} set z to {{nom:"vite"},{nom:"toto"}} collect items of z that match "vite" in user property "nom" (* divers enregistrements obtenus à partir d une liste de fichiers avec la commande Info For *) set p to {{name:"lettre0125.pdf",file creator:"caro",size:122884}, {name:"lettre0020.cwk",file creator:"bobo",size:12548}} collect items of p that match "BOBO" in subfield file creator -- résultat : {2} Notes Dans stringtosearch, vous pouvez utiliser les caractères suivants pour élargir la recherche. % $ + * / () &(>,<,=, ) Ce caractère permet de désactiver la sensibilité à la casse de la commande (voir exemple 1). Ce caractère permet de retourner également les éléments ne remplissant qu en partie stringtosearch (voir exemple 2). Ce caractère permet de remplacer n importe quel caractère (un joker) (voir exemple 3). Ce caractère permet de remplacer n importe quelle portion de la chaîne. (un super-joker) (voir exemple 4). Ce caractère impose une comparaison stricte (voir exemple 5). Ces caractères permettent de remplacer n importe quel caractère par ceux signifiés entre parenthèses (un joker limitatif) (voir exemple 6). Ces caractères permettent de remplacer n importe quel caractère par des expressions (voir exemple 7). Nicolas Descombes 05/ /5

4 Exemple 1 collect items of x that match "maison" collect items of x that match "%maison" Exemple 2 collect items of x that match "maisonnette" collect items of x that match "$maisonnette" Exemple 3 collect items of x that match "maiso+" collect items of x that match "d+man++" -- résultat : {2} Exemple 4 collect items of x that match "ma*" collect items of x that match "*ti*" -- résultat : {3} Exemple 5 collect items of x that match "/ma*" Exemple 6 collect items of x that match "(guj)lti(klm)(ba)" -- résultat : {3} Nicolas Descombes 05/ /5

5 Exemple 7 collect items of x that match "maiso&>m" collect items of x that match `(cde)em(ab)(mn)de` Ces caractères de substitution peuvent être combinés collect items of x that match "%(klm)+iso&>m" Les effets de tous ces caractères peuvent être désactivés avec le paramètre expression evaluation. Si ce paramètre vaut true, les effets des caractères seront actifs. Si ce paramètre vaut false, les effets des caractères seront inactifs, la comparaison se fera de façon absolue. collect items of x that match "mais*" expression evaluation true collect items of x that match "mais*" expression evaluation false Nicolas Descombes 05/ /5