Incrementally parses marked-up text to create a plain-text string and an attribute list.
See the [Pango Markup](pango_markup.html) docs for details about the supported markup.
If accel_marker
is nonzero, the given character will mark the character following it as an accelerator. For example,
accel_marker
might be an ampersand or underscore. All characters marked as an accelerator will receive a
pango_underline_low attribute, and the first character so marked will be returned in accel_char
, when calling [func@markup_parser_finish]. Two accel_marker
characters following each other produce a single literal
accel_marker
character.
To feed markup to the parser, use [[email protected]] on the returned [[email protected]]. When done with feeding markup to the parser, use [func@markup_parser_finish] to get the data out of it, and then use [ [email protected]] to free it.
This function is designed for applications that read Pango markup from streams. To simply parse a string containing Pango markup, the [ [email protected]_markup] API is recommended instead.
accel_marker |
character that precedes an accelerator, or 0 for none |
a `GMarkupParseContext` that should be destroyed with [[email protected]]. |