方法

GioDataInputStreamread_upto_finish

自：2.24

声明 [src]

char*
g_data_input_stream_read_upto_finish (
  GDataInputStream* stream,
  GAsyncResult* result,
  gsize* length,
  GError** error
)

描述 [src]

完成由 g_data_input_stream_read_upto_async() 开始的异步调用。

请注意，此函数不会消费停止字符。您必须在再次调用 g_data_input_stream_read_upto_async() 之前使用 g_data_input_stream_read_byte() 获取它。

返回的字符串在成功的情况下将始终以空字符终止。

自：2.24

参数

result

类型： GAsyncResult

提供给回调的 GAsyncResult。

数据由方法调用者拥有。
length

类型： gsize*

一个 #gsize，用于获取读取的数据长度。

此参数将由函数设置。
此参数可以 NULL。
error

类型： GError **

可恢复错误的返回位置。

此参数可以 NULL。
如果返回位置不是 NULL，则必须将其初始化为 NULL GError。
如果没有错误，方法将使此参数保持初始化为 NULL。
在发生错误的情况下，将使此参数设置为一个新的 GError；调用者将获取数据的所有权，并负责释放它。

返回值

类型： char*

在遇到任何停止字符之前读取的数据的字符串。将 length 设置为 #gsize 以获取字符串的长度。此函数在出现错误时将返回 NULL。

方法调用者获取返回数据的所有权，并负责释放它。
该值是一个以NUL结尾的UTF-8字符串。