GLibIOChannelread_chars

GIOStatus
g_io_channel_read_chars (
  GIOChannel* channel,
  gchar* buf,
  gsize count,
  gsize* bytes_read,
  GError** error
)

新 API 的 g_io_channel_read() 替代品。

buf

类型： guint8 数组

a buffer to read data into.

函数将设置该参数。

数组的长度由 count 参数指定的。

返回的数据由实例拥有。

count

类型： gsize

缓冲区的大小。注意，即使缓冲区中存在数据，缓冲区也可能不会被完全填满，如果剩余数据不是完整的字符。

bytes_read

类型： gsize*

读取的字节数。这可能会在成功时为零，如果 count < 6 且通道的编码非 NULL。这表示下一个 UTF-8 字符的宽度超过了缓冲区。

函数将设置该参数。

该参数可以是 NULL。

error

类型： GError **

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

该参数可以是 NULL。

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

如果没有错误，方法将保留初始化到 NULL。

在出错的情况下，将设置一个新分配的 GError；调用者将拥有数据，并负责释放它。

操作的状态。