方法
GLibUriParamsIternext
自 2.66 版本开始
声明 [来源]
gboolean
g_uri_params_iter_next (
GUriParamsIter* iter,
gchar** attribute,
gchar** value,
GError** error
)
描述 [来源]
将迭代器向前推进并检索下一个属性/值。如果发生错误(在此情况下将设置错误),或者达到了迭代的末尾(在此情况下将设置 attribute
和 value
为 NULL
,使迭代器无效),则返回 FALSE
。如果返回 TRUE
,则可以再次调用 g_uri_params_iter_next()
来接收另一个属性/值对。
请注意,相同的 attribute
可能会多次返回,因为 URI 允许重复属性。
自 2.66 版本开始可用
参数
attribute
-
类型:
gchar**
返回时包含属性,或
NULL
。该参数将由函数设置。 该方法可以将其设置为 NULL
。该参数可以是 NULL
。方法调用者获得返回数据的所有权,并负责释放它。 该值是一个以 NUL 结尾的 UTF-8 字符串。 value
-
类型:
gchar**
返回时包含值,或
NULL
。该参数将由函数设置。 该方法可以将其设置为 NULL
。该参数可以是 NULL
。方法调用者获得返回数据的所有权,并负责释放它。 该值是一个以 NUL 结尾的 UTF-8 字符串。 error
-
类型:
GError **
一个可恢复错误的返回位置。
该参数可以是 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,方法将用 NULL
初始化该参数。发生错误时,该参数将设置为一个新的 GError
;调用者将获得数据的所有权,并负责释放它。