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
- max
- min
- returnKey
- returnCount
- cObjNum
- 1,2,3,4
- wrap
Example

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
}

cObjNum ¶

Property: cObjNum
Data type: cObjNum + objects-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>

Example for cObject array

EXT:site_package/Configuration/TypoScript/setup.typoscript¶

{
= TEXT
stdWrap.current = 1
stdWrap.wrap = <b> | </b>
}

wrap ¶

Property: wrap
Data type: wrap + objects-optionsplit / stdWrap
Description: Defines a wrap for each item.

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>
}