# Function Reference

# _StringExplode

Splits up a string into substrings depending on the given delimiters as PHP Explode v5

#include <String.au3>
_StringExplode ( $sString, $sDelimiter [, $iLimit = 0] )

## Parameters

$sString | String to be split
$sDelimiter | Delimiter to split on (split is performed on entire string, not individual characters)
$iLimit | [optional] Maximum elements to be returned =0 : (default) Split on every instance of the delimiter >0 : Split until limit, last element will contain remaining portion of the string <0 : Split on every instance, removing limit count from end of the array

## Return Value

Returns an array containing the exploded strings.

## Remarks

Use negative limit values to remove the first possible elements.

## Example

    #include <Array.au3>
    #include <String.au3>

    Local $sText = "one##two##three##four##five##six##seven##eight"
    Local $aArray1 = _StringExplode($sText, "##", 0)
    _ArrayDisplay($aArray1, "StringExplode 0")

    ; DISPLAYED
    ; [0] = one
    ; [1] = two
    ; [2] = three
    ; [3] = four
    ; [4] = five
    ; [5] = six
    ; [6] = seven
    ; [7] = eight

    Local $aArray2 = _StringExplode($sText, "##", 4)
    _ArrayDisplay($aArray2, "StringExplode 4")

    ; DISPLAYED
    ; [0] = one
    ; [1] = two
    ; [2] = three
    ; [3] = four
    ; [4] = five##six##seven##eight

    Local $aArray3 = _StringExplode($sText, "##", -3)
    _ArrayDisplay($aArray3, "StringExplode -3")

    ; DISPLAYED
    ; [0] = one
    ; [1] = two
    ; [2] = three
    ; [3] = four
    ; [4] = five