Name
pglyphitem:Split -- split item
Synopsis
handle = pglyphitem:Split(text$, split_index)
Function
Modifies the glyph item to cover only the text after split_index, and returns a new item that covers the text before split_index that used to be in the glyph item.

You can think of split_index as the length of the returned item. split_index may not be 0, and it may not be greater than or equal to the length of the source glyph item (that is, there must be at least one byte assigned to each item, you can't create a zero-length item).

This function returns the newly allocated item representing text before split_index, which should be freed with pglyphitem:Free().

Inputs
text$
text to which positions in the glyph item apply
split_index
byte index of position to split item, relative to the start of the item
Results
handle
the newly allocated glyph item
Show TOC