en:explode [BASIC 256 - Language Documentation]

# BASIC 256 - Language Documentation

en:explode

## Explode (Function)

### Format

string_array_variable$ = explode ( string_expr , delimiter_expr )
string_array_variable$ = explode ( string_expr , delimiter_expr , boolean_expr )

returns string_array that must be assigned to a string_array_variable$

### Description

Splits up the string_expr into substrings wherever the delimiter_expr occurs. Substrings are stored in either the string or numeric array defined in the assignment statement. The array will be re-dimensioned to the exact size to store all of the substrings.

You may also specify an optional boolean value to specify that the search will treat upper and lower case letters the same.

### Example

    # explode on spaces
    a$ = "We all live in a yellow submarine."
    print a$
    w$ = explode(a$," ")
    for t = 0 to w$[?]-1
       print "w$["+t+"]=" + w$[t]
    next t
    # explode on A or a
    a$ = "klj;lkjalkjAlkj;"
    print a$
    w$ = explode(a$,"A",true)
    for t = 0 to w$[?]-1
       print "w$["+t+"]=" + w$[t]
    next t
    # explode numbers on comma
    a$="1,2,3,77,foo,9.987,6.45"
    print a$
    n = explode(a$,",")
    for t = 0 to n[?]-1
       print "n["+t+"]=" + n[t]
    next t

will display

    We all live in a yellow submarine.
    w$[0]=We
    w$[1]=all
    w$[2]=live
    w$[3]=in
    w$[4]=a
    w$[5]=yellow
    w$[6]=submarine.
    klj;lkjalkjAlkj;
    w$[0]=klj;lkj
    w$[1]=lkj
    w$[2]=lkj;
    1,2,3,77,foo,9.987,6.45
    n[0]=1
    n[1]=2
    n[2]=3
    n[3]=77
    n[4]=0
    n[5]=9.987
    n[6]=6.45

### See Also

Asc, Chr, Count, Countx, Explode, Explodex, Implode, Instr, Instrx, Left, Length, Lower, MD5, Mid, Midx, Replace, Replacex, Right, String, Upper

### History

0.9.6.55 | New to Version

en/explode.txt · Last modified: 2014/02/09 20:47 by admin