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

Type: string / stdWrap

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

max

max

Type: integer / stdWrap

Maximum number of splits.

min

min

Type: integer / stdWrap

Minimum number of splits.

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

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

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

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

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