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

Property
token
Data type
string / stdWrap
Description
String or character (token) used to split the value.

max

Property
max
Data type
integer / stdWrap
Description
Maximum number of splits.

min

Property
min
Data type
integer / stdWrap
Description
Minimum number of splits.

returnKey

Property
returnKey
Data type
integer / stdWrap
Description
Instead of parsing the split result, return the element of the index with this number immediately and stop processing of the split function.

returnCount

Property
returnCount
Data type
boolean / stdWrap
Description
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

Property
cObjNum
Data type
cObjNum + optionSplit / stdWrap
Description
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

Property
1,2,3,4,...
Data type
cObject / stdWrap
Description

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 cObject array
EXT:site_package/Configuration/TypoScript/setup.typoscript 
1 {
    10 = TEXT
    10.stdWrap.current = 1
    10.stdWrap.wrap = <b> | </b>
}
Copied!

wrap

Property
wrap
Data type
wrap + optionSplit / stdWrap
Description
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!