§ 4.104 - [splash] Built-InMnemonic aid: v vnamex [splash] ) splits content, optionally limit=N times, separated by the default comma or the separator specified by the optional sep= parameter, and passes it to the style specified by style=styleName if the (style=styleName,) option is used, while obeying the (pre=,), (post=,), (inter=,) and (ntl=,) options. If the (style=,) option is not used, then the results are returned verbatim. (style=styleName,) specifies a style to be called for each result. (limit=N,) specifies the maximum number of splits (results-1... specifying two splits means (up to) three results). (sep=,) specifies the string that separates the results. (pre=,) specifies a string to be emitted before each result. (post=,) specifies a string to be emitted after each result. (inter=,) specifies a string to be emitted between each result, unless (ntl=,) is also specified, in which case in between the next to last and the last result, (ntl=,) will be used instead. (ntl=,) specifies a string to be emitted between the next to last and the last result. On each iteration, [splash] ) sets the local variable loc_splashnum to a number indicating which result is being processed. The number starts with 1 and increases by one for each iteration. This value can be fetched by the called style, as that style is freshly evaluated upon each iteration. Tip:
If you would like to use a comma (,) character in the (pre=,), (post=,), (inter=,) or (ntl=,) options, use the comma escape, [co] ) . This will be converted into a literal comma in the results. Tip:
After the [splash] ) operation has run, you can retrieve the number of parameters that were created as current [parm] ) values during the most recent [splash] ) operation from the local variable loc_splashcount. In addition, each of the parameters may be retrieved using [parm N] ) . Caution:
Built-in and style usage placed in the (pre=,), (post=,), (inter=,) and (ntl=,) options is evaluated only once; this is why the enumerate example uses a subordinate style, numit, to fetch the loc_splashnum value rather than placing it in the (pre=,) option. Other built-ins used here: [parm N] )
Keyboard Navigation
, Previous Page . Next Page t TOC i Index on January 10th, 2026 at 2:38 MT |