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

max

Data type

integer /stdWrap

Description

Maximum number of splits.

Property

min

Data type

integer /stdWrap

Description

Minimum number of splits.

Property

returnKey

Data type

integer /stdWrap

Description

Instead of parsing the split result, just return the element of the index with this number immediately and stop processing of the split function.

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:

# returns 9
1 = TEXT
1 {
    value = x,y,z,1,2,3,a,b,c
    split.token = ,
    split.returnCount = 1
}

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

wrap

Data type

wrap +optionSplit /stdWrap

Description

Defines a wrap for each item.

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