REBOL Document

Join - Function Summary


Summary:

Concatenates values.

Usage:

join value rest

Arguments:

value - Base value

rest - Value or block of values

Description:

Creates a new value as the return. The first argument determines the datatype of the returned value. When the first argument is a type of series, the return value will be that type of series (STRING, FILE, URL, BLOCK, etc.). When the first argument is a scalar value, the return will always be a string. When the second argument is a block, it will be evaluated and all of its values joined to the return value.


    probe join "super" "duper"
    "superduper"


    probe join %file ".txt"
    %file.txt


    probe join http:// ["www.rebol.com/" %index.html]
    http://www.rebol.com/index.html


    probe join "t" ["e" "s" "t"]
    "test"


    probe join 11:11 "PM"
    "11:11PM"


    probe join [1] ["two" 3 "four"]
    [1 "two" 3 "four"]

Related:

form - Converts a value to a string.
insert - Inserts a value into a series and returns the series after the insert.
mold - Converts a value to a REBOL-readable string.
reform - Forms a reduced block and returns a string.
rejoin - Reduces and joins a block of values.
remold - Molds a reduced block and returns a string.


<Back | Index | Next>

Copyright 2004 REBOL Technologies