方法

GioDataInputStreamread_line_finish

since: 2.20

声明 [src]

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

描述 [src]

完成 g_data_input_stream_read_line_async() 启动的异步调用。注意，关于字符串编码的警告在 g_data_input_stream_read_line() 中同样适用。

自 2.20 版本可用

参数

result

类型： GA异步结果

提供给回调的 GA异步结果。

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

类型： gsize*

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

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

类型： GA错误 **

可恢复错误的返回位置。

参数可以是 NULL。
如果返回位置不是 NULL，那么您必须将其初始化为 NULL 的 GA错误*。
如果没有错误，方法将通过参数将留初始化到 NULL。
发生错误时，参数将设置为一个新的 GA错误；调用者将负责拥有数据，并负责释放它。

返回值

类型： 提供了 guint8 的数组

一个 NUL 结束的字节数组，包含读取的行（不包含换行符）。通过设置 length 为 #gsize 来获取读取行的长度。在发生错误时，它将返回 NULL 并设置 error。如果没有内容要读取，它仍然会返回 NULL，但 error 不会设置。

数组以 NULL 结尾。
方法的调用者获得返回数据的所有权，并负责释放它。
返回值可能是 NULL。