split

This object is used to split the input by a character and then parse the result onto some functions.

For each iteration the split index starting with 0 (zero) is stored in the register key SPLIT_COUNT.

Properties

token

token
Data type

string / stdWrap

String or character (token) used to split the value.

max

max
Data type

integer / stdWrap

Maximum number of splits.

min

min
Data type

integer / stdWrap

Minimum number of splits.

returnKey

returnKey
Data type

integer / stdWrap

Instead of parsing the split result, return the element of the index with this number immediately and stop processing of the split function.

returnCount

returnCount
Data type

boolean / stdWrap

Counts all elements resulting from the split, returns their number and stops processing of the split function.

Example

EXT:site_package/Configuration/TypoScript/setup.typoscript
# returns 9
1 = TEXT
1 {
    value = x,y,z,1,2,3,a,b,c
    split.token = ,
    split.returnCount = 1
}

cObjNum

cObjNum
Data type

cObjNum + optionSplit / stdWrap

This is a pointer the array of this object ("1,2,3,4"), that should treat the items, resulting from the split.

1,2,3,4

1,2,3,4,...
Data type

cObject / stdWrap

The object that should treat the value.

Note: The "current"-value is set to the value of current item, when the objects are called. See stdWrap / current.

Example for stdWrap

EXT:site_package/Configuration/TypoScript/setup.typoscript
1.current = 1
1.wrap = <b> | </b>

Example for stdWrap

EXT:site_package/Configuration/TypoScript/setup.typoscript
1 {
    10 = TEXT
    10.stdWrap.current = 1
    10.stdWrap.wrap = <b> | </b>
}

wrap

wrap
Data type

wrap + optionSplit / stdWrap

Defines a wrap for each item.

Example

This is an example of TypoScript code that imports the content of field "bodytext" from the $cObj->data-array (ln 3). The content is split by the line break character (ln 5). The items should all be treated with a stdWrap (ln 6) which imports the value of the item (ln 7). This value is wrapped in a table row where the first column is a bullet-gif (ln 8). Finally the whole thing is wrapped in the proper table-tags (ln 10). :

 120 = TEXT
 220.stdWrap {
 3    field = bodytext
 4    split {
 5        token.char = 10
 6        cObjNum = 1
 7        1.current = 1
 8        1.wrap = <tr><td><img src="dot.gif"></td><td> | </td></tr>
 9    }
10    stdWrap.wrap = <table style="width: 368px;"> | </table><br>
11}