Split ViewHelper <f:split>

The SplitViewHelper splits a string by the specified separator, which results in an array. The number of values in the resulting array can be limited with the limit parameter, which results in an array where the last item contains the remaining unsplit string.

This ViewHelper mimicks PHP's explode() function.

The following examples store the result in a variable because an array cannot be outputted directly in a template.

Examples

Split with a separator

<f:variable name="result"><f:split value="1,5,8" separator="," /></f:variable>
Copied!
{0: '1', 1: '5', 2: '8'}
Copied!

Split using tag content as value

<f:variable name="result"><f:split separator="-">1-5-8</f:split></f:variable>
Copied!
{0: '1', 1: '5', 2: '8'}
Copied!

Split with a limit

<f:variable name="result"><f:split value="1,5,8" separator="," limit="2" /></f:variable>
Copied!
{0: '1', 1: '5,8'}
Copied!

Go to the source code of this ViewHelper: SplitViewHelper.php (GitHub).

Arguments

The following arguments are available for the split ViewHelper:

limit

limit
Type
int
Default
9223372036854775807
If limit is positive, a maximum of $limit items will be returned. If limit is negative, all items except for the last $limit items will be returned. 0 will be treated as 1.

separator

separator
Type
string
Required
1
Separator string to explode with

value

value
Type
string
The string to explode