方法

GLibIOChannelread_line

声明 [源]

GIOStatus
g_io_channel_read_line (
  GIOChannel* channel,
  gchar** str_return,
  gsize* length,
  gsize* terminator_pos,
  GError** error
)

描述 [源]

从 GIOChannel 中读取一行（包括终止字符），到一个新分配的字符串中。如果返回 G_IO_STATUS_NORMAL，则 str_return 将包含分配的内存。

参数

str_return

类型： gchar**

从 GIOChannel 中读取的行，包括行终止符。这些数据应当在不再需要时使用 g_free() 释放。这是一个空终止的字符串。如果返回的 length 为零，则此将为 NULL。

该参数将由函数设置。
调用此方法的对象将获得返回数据的所有权，并负责释放它。
该值是一个空终止的 UTF-8 字符串。
length

类型： gsize*

存储读取数据的长度位置的地址，或 NULL。

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

类型： gsize*

存储行终止符位置的地址，或 NULL。

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

类型： GError **

可用于恢复错误的返回位置的地址。

该参数可以是 NULL。
如果返回位置的地址不是 NULL，则必须将其初始化为 NULL 的 GError*。
如果没有错误，方法将初始化参数为 NULL。
如果发生错误，参数将设置为一个新的 GError；调用者将获得数据的所有权，并负责释放它。

返回值

类型： GIOStatus

操作的状态。