Package: pango

Function pango-itemize

Lambda List

pango-itemize (context text start length attrs iter)

Arguments

context -- a pango-context object holding information that affects the itemization process
text -- a string with the text to itemize, must be valid UTF-8
start -- an integer with the first byte in text to process
length -- an integer with the number of bytes (not characters) to process after start, this must be >= 0
attrs -- the pango-attr-list set of attributes that apply to text
iter -- cached pango-attr-iterator attribute iterator, or nil

Return Value

A list of pango-item instances.

Details

Breaks a piece of text into segments with consistent directional level and shaping engine. Each byte of text will be contained in exactly one of the items in the returned list. The generated list of items will be in logical order, the start offsets of the items are ascending.

The argument iter should be an iterator over attrs currently positioned at a range before or containing start. The argument iter will be advanced to the range covering the position just after start + length, i.e. if itemizing in a loop, just keep passing in the same iter.
 

See also

2021-1-12