方法

GioDataInputStreamread_line

声明 [src]

char*
g_data_input_stream_read_line (
  GDataInputStream* stream,
  gsize* length,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

从数据输入流中读取一行。请注意，不执行编码检查或转换；输入不保证是UTF-8，实际上可能包含嵌入的NUL字符。

如果cancellable不是NULL，则可以从另一个线程触发可取消对象取消操作。如果操作被取消，将返回错误G_IO_ERROR_CANCELLED。

参数

长度

类型： gsize*

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

此参数将由函数设置。
此参数可以是NULL。
可取消的任务

类型： GCancellable

可选的GCancellable对象，NULL表示忽略。

此参数可以是NULL。
数据是方法调用者的拥有。
错误

类型： GError **

一个可恢复错误返回位置的GError。

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

返回值

类型： 一个guint8数组

一个以NUL终止的包含读取行的字节数组（不带换行符）。将length设置为gsize以获取读取行的长度。在错误情况下，它将返回NULL并且设置error。如果没有内容要读取，它仍然会返回NULL，但是error不会设置。

数组以NULL终止。
方法调用的调用者拥有返回的数据，并负责释放它。
返回值可以为空。