函数

GioInitablenew

since: 2.22

声明 [源]

GObject*
g_initable_new (
  GType object_type,
  GCancellable* cancellable,
  GError** error,
  const gchar* first_property_name,
  ...
)

描述 [源]

用于构建 GInitable 对象的辅助函数。这与 g_object_new() 类似，但还初始化对象并在失败时返回 NULL，并设置错误。

可用以来：2.22

此函数对语言绑定不可直接使用。

参数

object_type

类型: GType

支持添加 GInitable 的 GType。

cancellable

类型: GCancellable

可选的 GCancellable 对象，NULL 表示忽略。

此参数可以是 NULL。
数据由函数的调用者拥有。
error

类型: GError

存储发生错误的 GError 位置，或 NULL 表示忽略。

数据由函数的调用者拥有。
first_property_name

类型: const gchar*

首个属性的名称，如果没有属性则为 NULL。

此参数可以是 NULL。
数据由函数的调用者拥有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
...

类型: 

第一个属性的值，后跟其他属性值对，并由 NULL 结束。

返回值

类型: GObject

新分配的 GObject，或者在发生错误时为 NULL。

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