函数
Pangoparse_markup
声明 [src]
gboolean
pango_parse_markup (
const char* markup_text,
int length,
gunichar accel_marker,
PangoAttrList** attr_list,
char** text,
gunichar* accel_char,
GError** error
)
说明 [src]
解析有标记的文本,以创建纯文本串和属性列表。
有关支持的标记的详细信息,请参见 Pango 标记 文档。
如果 accel_marker
为非零,则给定字符将把紧跟其后的字符标记为加速键。例如,accel_marker
可能为一个和号或下划线。所有标记为加速键的字符都将接收到一个 PANGO_UNDERLINE_LOW
属性,而第一个如此标记的字符将返回给 accel_char
。两个 accel_marker
字符紧跟在彼此之后会产生一个单一的文字 accel_marker
字符。
要逐步解析一串 pango 标记,请使用 pango_markup_parser_new()
。
如果发生任何错误,则除了 error
之外,任何输出参数都不会被修改。
参数
markup_text
-
类型:
const char*
要解析的标记(请参阅 Pango 标记 文档)。
该数据由函数的调用者所有。 该值是一个以 NUL 结尾的 UTF-8 字符串。 length
-
类型:
int
markup_text
的长度,如果是以 nul 结尾的,则为 -1。 accel_marker
-
类型:
gunichar
表示加速键的前一个字符,如果无,则为 0。
attr_list
-
类型:
PangoAttrList
PangoAttrList
的返回位置的地址。该参数将由函数设置。 该参数可以为 NULL
。函数的调用者承担返回数据的所权,并负责释放它。 text
-
类型:
char**
取消标记的文本的返回位置的地址。
该参数将由函数设置。 该参数可以为 NULL
。函数的调用者承担返回数据的所权,并负责释放它。 该值是一个以 NUL 结尾的 UTF-8 字符串。 accel_char
-
类型:
gunichar*
加速键字符的返回位置的地址。
该参数将由函数设置。 该参数可以为 NULL
。 error
-
类型:
GError **
可恢复错误 的返回位置。
该参数可以为 NULL
。如果返回位置不为 NULL
,则必须将其初始化为一个NULL
GError*
。如果没有错误,该参数将被函数保留初始化为 NULL
。如果发生错误,该参数将被设置为一个新分配的 GError
;调用者将承担该数据的所权,并负责释放它。