articles:dicorebol-fr:insert [RebolFranceWiki]

Insert - Détail de la fonction

En résumé:

Insère une valeur dans une série et retourne la série après l’insertion.

Utilisation:

insert series value

Arguments:

series - Série au point d’insertion (type: series port bitset) value - La valeur à insérer (type: any-type)

Raffinements:

/part - Limite sur une longueur ou jusqu’à une position donnée.

range - L’intervalle. (type: number series port pair)

/only - Insère une série en tant que série.

/dup - Répète l’insertion le nombre de fois spécifié.

count - Le nombre de répétitions. (type: number pair)

Description:

Si le second argument est une série compatible avec le premier (un type de donnée basé sur bloc ou les chaînes de caractères,) toutes ses valeurs seront insérées. Pour faciliter les insertions en cascade, la fonction INSERT retourne la série positionnée juste après l’insertion.

Cette fonction accepte de nombreux raffinements.

/PART vous permet de spécifier combien d’éléments vous voulez insérer.

/ONLY forcera l’insertion d’un bloc, plutôt que ses éléments individuels. (Seulement fait si le premier argument est d’un type bloc.)

/DUP répétera la série insérée le nombre de fois spécifié.

La série sera modifiée.

    str: copy "here this"
    insert str "now "
    print str
    now here this

    insert tail str " message"
    print str
    now here this message

    insert tail str reduce [tab now]
    print str
    now here this message	9-Mar-2004/0:59:54-8:00

    insert insert str "Tom, " "Tina, "
    print str
    Tom, Tina, now here this message	9-Mar-2004/0:59:54-8:00

    insert/dup str "." 7
    print str
    .......Tom, Tina, now here this message	9-Mar-2004/0:59:54-8:00

    insert/part tail str next "!?$" 1
    print str
    .......Tom, Tina, now here this message	9-Mar-2004/0:59:54-8:00?

    blk: copy ["hello"]
    insert blk 'print
    probe blk
    [print "hello"]

    insert tail blk http://www.rebol.com
    probe blk
    [print "hello" http://www.rebol.com]

    insert/only blk [separate block]
    probe blk
    [[separate block] print "hello" http://www.rebol.com]

Fonctions en relation:

append - Ajoute une valeur à la queue d’une série et retourne la série positionnée à sa tête.

change - Change une valeur dans une série et retourne la série après la modification.

clear - Retire toutes les valeurs depuis l’index actuel jusqu’à la queue de la série. Retourne la série à sa queue.

join - Concatène des valeurs.

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