函数

GioInitablenewv

已弃用:2.54 自:2.22

声明 [src]

GObject*
g_initable_newv (
  GType object_type,
  guint n_parameters,
  GParameter* parameters,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

创建GInitable对象的帮助函数。这与g_object_newv()类似,但也初始化对象并在失败时返回NULL,并设置错误。

自2.22起可用

自2.54起弃用

请改用g_object_new_with_properties()和g_initable_init()。有关更多信息,请参阅GParameter。

参数

object_type

类型: GType

支持GInitable的GType。

n_parameters

类型: guint

parameters中参数的数量。

parameters

类型: 包含GParameter的数组

用于构建对象的参数。

数组的长度由n_parameters参数指定。
数据由函数的调用者拥有。
cancellable

类型: GCancellable

可选GCancellable对象,为NULL时忽略。

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

类型: GError **

用于返回一个可恢复的错误的位置。

该参数可以是NULL
如果返回位置不是NULL,则必须将其初始化为NULL GError*
如果没有错误,则该函数将保留初始化为NULL
在出现错误的情况下,该参数将设置为一个新的GError;调用者将拥有数据的所有权,并负责释放它。

返回值

类型: GObject

一个新分配的GObject,或者在错误时为NULL

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