Function pango::functions::itemize [−][src]
pub fn itemize(
context: &Context,
text: &str,
start_index: i32,
length: i32,
attrs: &AttrList,
cached_iter: Option<&AttrIterator>
) -> Vec<Item>
Expand description
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).
cached_iter
should be an iterator over attrs
currently positioned at a
range before or containing start_index
; cached_iter
will be advanced to
the range covering the position just after start_index
+ length
.
(i.e. if itemizing in a loop, just keep passing in the same cached_iter
).
context
a structure holding information that affects the itemization process.
text
the text to itemize. Must be valid UTF-8
start_index
first byte in text
to process
length
the number of bytes (not characters) to process
after start_index
.
This must be >= 0.
attrs
the set of attributes that apply to text
.
cached_iter
Cached attribute iterator, or None
Returns
a GList
of Item
structures. The items should be freed using pango_item_free()
probably in combination with g_list_foreach()
, and the list itself
using g_list_free()
.