虚拟方法

GioInputStreamskip

声明 [源]

gssize
skip (
  GInputStream* stream,
  gsize count,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

尝试从流中跳过count个字节。操作将阻塞。

从行为上看,这与g_input_stream_read()相同,但跳过的字节数不会返回给用户。一些流的实现比读取数据更高效。

对于继承的类,此函数是可选的,因为默认实现使用read来模拟它。

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

参数

count

类型: gsize

要跳过流中的字节数。

cancellable

类型: GCancellable

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

此参数可以为NULL
数据由方法的调用者所有。
error

类型: GError **

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

此参数可以为NULL
如果返回位置不是NULL,则必须将其初始化为NULL GError*
如果虚拟函数没有错误,则将保留初始化参数为NULL
如果发生错误,则将参数设置为新分配的GError;调用者将负责数据的所有权和释放。

返回值

类型: gssize

跳过的字节数,或错误时为-1。