方法

GioDataInputStreamread_line_finish_utf8

自：2.30

声明 [src]

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

描述 [src]

完成由 g_data_input_stream_read_line_async() 启动的异步调用。

自：2.30

参数

result

类型： GAsyncResult

提供给回调的 GAsyncResult。

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

length

类型： gsize*

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

该参数将由函数设置。

该参数可以是 NULL。

error

类型： GError **

可恢复错误的返回位置。

该参数可以是 NULL。

如果返回位置不是 NULL，则必须将其初始化为一个 NULL GError*。

如果没有错误，该方法将保留初始化的参数为 NULL。

如果发生错误，参数将设置为一个新的 GError；调用者将接管数据，并负责释放它。

返回值

类型： char*

一个包含读取行的字符串（不带换行符）。将 length 设置为 #gsize 以获取读取行的长度。在发生错误时，它将返回 NULL 并设置 error。对于 UTF-8 转换错误，设置错误域为 G_CONVERT_ERROR。如果没有内容可读，它还将返回 NULL，但不会设置 error。

方法的调用者接管返回的数据，并负责释放它。

返回值可以是 NULL。

值是一个空终止的 UTF-8 字符串。