Breaks a string of text into separate characters.

To display a list of all the separate characters in a string, use a [ListChars] context.

Example (normally you would put the following text into a .tpl file on your server and use a web browser to link to it):

[ListChars chars=WebDNA 6.0]
[index]: [char]<br>
[/ListChars]

The example above yields:

1: W
2: e
3: b
4: D
5: N
6: A
7:
8: 6
9: .
10: 0

The following parameters are used in the [ListChars] context:

Parameter	Description
chars	(Required) string of text to break up.
from	(Optional) Sets the direction the 'chars' string is parsed. Default is 'START'. If set to 'END' , characters will be listed starting from the end of the 'chars' string, to the beginning.
start	(Optional) Sets the start posotion, in the 'chars' string, from which to list the characters. If not specified, characters will be listed starting from the first position in the string. If the 'From' parameter is set to 'END', the 'start' position is relative to the end of the 'chars' string.
end	(Optional) Sets the end posotion, in the 'chars' string, from which to stop listing the characters. If not specified, characters will be listed starting from the 'start' position, and up to the last position in the string. If the 'From' parameter is set to 'END', the 'last' position is relative to the end of the 'chars' string.

The following tags are available inside a [ListChars] context:

Tag	Description
[index]	A number from 1 to the total number of chars in the text indicating the iteration index.
[char]	The current character of the 'chars' string being iterated.
[position]	The current character position. The position is '1' based, and is relative to the start of the 'chars' string, unless the from parameters is set to 'END', in which case 'position' is relative to the end of the 'chars' string.

Example 2

[listchars chars=1234567890.abcdefg&start=4&end=10&from=end] Character at string position [position] = '[char]'
[/listchars]

The example above yields:

Character at string position 4 = 'd'
Character at string position 5 = 'c'
Character at string position 6 = 'b'
Character at string position 7 = 'a'
Character at string position 8 = '.'
Character at string position 9 = '0'
Character at string position 10 = '9'