方法

GioBufferedInputStreamread_byte

声明 [src]

int
g_buffered_input_stream_read_byte (
  GBufferedInputStream* stream,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

尝试从流或缓冲区中读取一个字节。在此读取期间会阻塞。

成功时,返回从流中读取的字节。在流末尾返回-1,但它不是异常错误,且不设置error。

如果 cancellable 不是 NULL,则可以由另一个线程触发可取消对象来取消操作。如果操作被取消,将返回错误G_IO_ERROR_CANCELLED。如果操作在取消时部分完成,则返回部分结果,不返回错误。

错误时返回 -1 并相应地设置error。

参数

cancellable

类型: GCancellable

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

该参数可以为 NULL
数据由方法调用者拥有。
error

类型: GError **

用于可恢复错误的返回位置的 a recoverable error.

该参数可以为 NULL
如果返回位置不为 NULL,则必须将其初始化为 NULL GError*
如果没有错误,方法将保持参数初始化为 NULL
如果出现错误,该参数将被设置为一个新的 GError;调用者将负责拥有数据,并负责释放它。

返回值

类型: int

stream 读取的字节,或在流末尾或发生错误时返回 -1