Attention
TYPO3 v7 has reached its end-of-life November 30th, 2018 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.
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.
Property
token
Data type
string /stdWrap
Description
String or character (token) used to split the value.
Property
returnKey
Data type
integer /stdWrap
Description
Instead of parsing the split result, just return this element of the index immediately.
Property
returnCount
Data type
integer
Description
Returns the number of split items
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.
Property
1,2,3,4
Data type
->CARRAY /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:
1.current = 1
1.wrap = <b> | </b>
Example for CARRAY:
1 {
10 = TEXT
10.stdWrap.current = 1
10.stdWrap.wrap = <b> | </b>
}
Property
returnCount
Data type
boolean /stdWrap
Description
Counts all elements resulting from the split.
Example:
# returns 9
1 = TEXT
1 {
value = x,y,z,1,2,3,a,b,c
split.token = ,
split.returnCount = 1
}
[tsref:->split]
Example:¶
This is an example of TypoScript code that imports the content of field "bodytext" from the $cObj->data-array (ln 2). The content is split by the line break character (ln 4). The items should all be treated with a stdWrap (ln 5) which imports the value of the item (ln 6). This value is wrapped in a table row where the first column is a bullet-gif (ln 7). Finally the whole thing is wrapped in the proper table-tags (ln 9).
1 20 = TEXT
2 20.stdWrap.field = bodytext
3 20.stdWrap.split {
4 token.char = 10
5 cObjNum = 1
6 1.current = 1
7 1.wrap = <tr><td><img src="dot.gif"></td><td> | </td></tr>
8 }
9 20.stdWrap.wrap = <table style="width: 368px;"> | </table><br>