方法

GLibUriParamsIternext

自 2.66 版本开始

声明 [来源]

gboolean
g_uri_params_iter_next (
  GUriParamsIter* iter,
  gchar** attribute,
  gchar** value,
  GError** error
)

描述 [来源]

将迭代器向前推进并检索下一个属性/值。如果发生错误(在此情况下将设置错误),或者达到了迭代的末尾(在此情况下将设置 attributevalueNULL,使迭代器无效),则返回 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;调用者将获得数据的所有权,并负责释放它。

返回值

类型: gboolean

如果已到达参数的末尾或遇到错误,则返回 FALSE。否则返回 TRUE