函数

Pangoparse_enum

已弃用:1.38 自:1.16

声明 [src]

gboolean
pango_parse_enum (
  GType type,
  const char* str,
  int* value,
  gboolean warn,
  char** possible_values
)

描述 [src]

解析枚举类型并将结果存储在 value 中。

如果 str 与枚举的任何可能值昵号不匹配,且不是一个整数,则返回 FALSE,如果 warnTRUE,则发出警告,并存储一个表示可能值列表的字符串至 possible_values 中。此列表由斜杠分隔,例如“none/start/middle/end”。

如果失败且 possible_values 不为 NULL,则应使用 g_free() 释放返回的字符串。

自 1.16 起可用

自 1.38 起弃用

请勿在新建代码中使用。

参数

类型

类型: GType

要解析的枚举类型,例如 PANGO_TYPE_ELLIPSIZE_MODE

str

类型: const char *

要解析的字符串。

参数可以为 NULL
此数据由函数调用者所有。
此值为以 NUL 结尾的 UTF-8 字符串。

类型: int *

用于存储结果的整数。

参数将由该函数设置。
参数可以为 NULL
警告

类型: gboolean

如果为 TRUE,则在输入不当时发出 g_warning()

possible_values

类型: char **

在失败时存储可能值列表的位置。

参数将由该函数设置。
参数可以为 NULL
函数调用者获取返回数据的权限,并负责释放它。
此值为以 NUL 结尾的 UTF-8 字符串。

返回值

类型: gboolean

如果成功解析 str,则为 TRUE