函数

GioInitablenew_valist

从版本:2.22开始

声明 [src]

GObject*
g_initable_new_valist (
  GType object_type,
  const gchar* first_property_name,
  va_list var_args,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

用于构造GInitable对象的辅助函数。这类似于g_object_new_valist(),但还会初始化对象,在失败时返回NULL,并将错误设置.

自2.22以来可用

此函数不直接提供给语言绑定。

参数

object_type

类型: GType

支持GInitableGType

first_property_name

类型: const gchar*

第一个属性的名称,后跟值,以及其他属性值对,并以NULL结束。

数据由函数的调用者拥有。
值是空终止的UTF-8字符串。
var_args

类型: va_list

first_property_name生成的var args列表。

cancellable

类型: GCancellable

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

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

类型: GError **

用于可恢复错误的返回位置的地址。

参数可以为NULL
如果返回位置的地址不是NULL,则必须将其初始化为NULL GError*
如果没有错误,函数将保留初始化的参数为NULL
在出错时,参数将设置为新的GError的分配;调用者将负责数据,并释放它。

返回值

类型: GObject

新分配的GObject,或在出错时返回NULL

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