textSplit (text -- characterList)

Inputs

• text: Known Text to split.

Outputs

• characterList: List of one-character Text items, or the empty Tuple when text is empty.

textSplit splits known non-NIL Text by decoded UTF-8 characters. Byte counts are provided by textSize.

Splitting is by decoded UTF-8 characters, not by raw bytes. Empty Text yields the empty Tuple (). Nonempty Text yields a List of one-character Text items.

Example

{} () {} [
  "" textSplit printStack _:;
  "你好" textSplit printStack _:;
] "main" exportFunction

Expected Output During Compilation

()
("你" "好")

See also

• & builtin (prefix suffix -- text) Concatenates two known Text values.
• LF builtin (-- lineFeed) Pushes a line-feed Text constant.
• attribute builtin (attribute --) Consumes one known Text attribute string and produces no value.
• textSize builtin (text -- size) Returns the UTF-8 code-unit (byte) count of a Text value as known or unknown Natx; known NIL text is invalid.