方法

GioInputStreamskip

声明 [源代码]

gssize
g_input_stream_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。