函数

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;调用者将承担该数据的所权,并负责释放它。

返回值

类型: gboolean

如果设置了 error,则为 FALSE,否则为 TRUE