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

token
Type
string / stdWrap

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

max

max

max
Type
integer / stdWrap

Maximum number of splits.

min

min

min
Type
integer / stdWrap

Minimum number of splits.

returnKey

returnKey

returnKey
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

returnCount
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
}
Copied!

cObjNum

cObjNum

cObjNum
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,...

1,2,3,4,...
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>
Copied!
Example for stdWrap
EXT:site_package/Configuration/TypoScript/setup.typoscript
1 {
    10 = TEXT
    10.stdWrap.current = 1
    10.stdWrap.wrap = <b> | </b>
}
Copied!

wrap

wrap

wrap
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). :

20 = TEXT
20.stdWrap {
    field = bodytext
    split {
        token.char = 10
        cObjNum = 1
        1.current = 1
        1.wrap = <tr><td><img src="dot.gif"></td><td> | </td></tr>
    }
    stdWrap.wrap = <table style="width: 368px;"> | </table><br>
}
Copied!