函数

GLibOptionGroupnew

自：2.6

声明 [源]

GOptionGroup*
g_option_group_new (
  const gchar* name,
  const gchar* description,
  const gchar* help_description,
  gpointer user_data,
  GDestroyNotify destroy
)

描述 [源]

创建一个新的 GOptionGroup。

description 通常用于提供组的标题。如果是这样，建议使用标题首字母大写，并在句尾添加冒号，以便与内置 GLib 组标题（如‘应用程序选项:’）的样式相匹配。

支持自：2.6

参数

name

类型： const gchar*

选项组的名称，用于通过 --help-``name 为该组中的选项提供帮助。

数据由函数的调用者拥有。
值是 NUL 结束的 UTF-8 字符串。
description

类型： const gchar*

显示在 --help 中的此组的描述。该字符串使用组的翻译域或翻译函数进行翻译。

数据由函数的调用者拥有。
值是 NUL 结束的 UTF-8 字符串。
help_description

类型： const gchar*

--help-``name 选项的描述。该字符串使用组的翻译域或翻译函数进行翻译。

数据由函数的调用者拥有。
值是 NUL 结束的 UTF-8 字符串。
user_data

类型： gpointer

将传递给解析前和解析后钩子、错误钩子和 G_OPTION_ARG_CALLBACK 选项的回调，或 NULL。

参数可以 NULL。
数据由函数的调用者拥有。
destroy

类型： GDestroyNotify

将调用以释放 user_data 的函数，或 NULL。

返回值

类型： GOptionGroup

创建的新选项组。它应添加到 GOptionContext 或使用 g_option_group_unref() 释放。

函数的调用者拥有数据，并负责释放它。