articles:dicorebol-fr:alter [RebolFranceWiki]

Alter - Détail de la fonction

En résumé :

Si une valeur n’est pas trouvée dans une série, l’ajoute; sinon, la retire.

Utilisation :

alter series value

Arguments :

series - La série en argument. (type: series port)

value - La valeur en argument.

Description :

La fonction ALTER est un opération sur les ensembles de données. Elle ajoute ou retire une valeur selon sa présence préalable dans l’ensemble. Le mot ALTER est un raccourci pour le mot “alternate”.

Par exemple, disons que vous voulez garder la trace de quelques options utilisées par votre code. Ces options peuvent être: FARINE, SUCRE, SEL, et POIVRE. Le code suivant va créer un nouveau bloc (pour contenir l’ensemble de données) et lui ajouter des éléments:

    options: copy []
    alter options 'SEL
    probe options
    [SEL]

    alter options 'SUCRE
    probe options
    [SEL SUCRE]

Vous pouvez utiliser des fonctions comme FIND pour tester la présence d’une option dans l’ensemble:

    if find options 'SEL [print "Sel a été trouvé"]
    Sel a été trouvé

Si vous utilisez ALTER une seconde fois pour le même mot, il sera retiré:

    alter options 'SEL
    probe options
    [SUCRE]

Normalement, les valeurs ALTER sont des mots symboliques (comme ceux montrés ci-dessus) mais n’importe quel type de donnée peut être utilisé tel que les entiers (integer!,) les chaînes de caractères (string!,) etc.

    alter options 120
    alter options "test"
    probe options
    [SUCRE 120 "test"]

Fonctions en relation :

difference - Retourne la différence de deux ensembles de données.

exclude - Retourne le premier ensemble moins le second.

find - Trouve une valeur dans une série retourne la série au début de cette valeur.

intersect - Crée une nouvelle valeur qui est l’intersection des deux arguments.

remove - Retire une ou des valeurs d’une série et retourne la série après la modification.

unique - Retourne un ensemble avec les valeurs doubles retirées.

Version anglaise officielle :

http://www.rebol.com/docs/words/walter.html

Commentaires des utilisateurs :

-Soumis par: giesse_writeme.com 7-Dec-2000/2:41:57-8:00:

Notez que cette fonction retourne la tête de la liste lorsque la valeur est ajoutée, mais retourne la position après la modification lorsque la valeur est retirée.