| **Navigation:**  [[templates.htm|Templates]] > [[tlrcontents.htm|Template Language Reference]] > Built-in Template Procedures >====== SPLIT (separate single line string to multiple lines) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[slice  return substring from string .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[tailname extract file name from full path .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**SPLIT ( **//string//** [, **//splitcolumn//** ] [, **//indent//** ] )**

{{blk2blue.jpg|blk2blue.jpg}}

| **SPLIT** | Split a single comma delimited list of attributes to multiple lines |
| //string// | A string constant, template symbol or expression containing a comma delimited list of attributes. |
| //splitcolumn// | An integer constant, template symbol or expression that identifies what column to split the line at. |
| //indent// | An integer constant, template symbol or expression that designates the amount of spaces to indent on all lines generated after the first line. |

**SPLIT** is used to divide a long string of comma delimited attributes into multiple lines. As each new line is created, they are connected using the line continuation ( | ) character, which is automatically generated. Lines are split near to the value of the //splitcolumn// column value (before or after) based on the Clarion syntax at that position. Subsequent lines are indented using the //indent// value to determine the number of leading spaces.

If the //splitcolumn// parameter is omitted, a default value of 90 is used.

If the //indent// parameter is omitted, a default value of 2 is used.

We need to clarify the term "comma delimited list of attributes" as used in SPLIT, UNSPLIT, EXTRACT, REPLACE and SEPARATOR functions. These functions assume that the //string// parameter has the following form:

**[<;label>]  <;attribute>,<;attribute>,<;attribute>, ...**

In addition, each **<;attribute>** has the following format:

**<;name>[([<;parameter>],[<;parameter>],...)]**

**<;name>** is an identifier, or an identifier with a leading # character or a string constant. **<;parameter>** is any valid expression.

The list of attributes may also have a leading **<;label>**, which is an identifier, and separated from the first attribute by one or more whitespaces.

**See Also:** [[unsplit merge a multiple line string to single line .htm|UNSPLIT]], [[extract  return attribute .htm|EXTRACT]], [[replace  replace attribute .htm|REPLACE]], [[separator  return attribute string delimiter position .htm|SEPARATOR]]

[[built in template procedures.htm|Built-In Template Procedures]]