方法
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
;调用者将负责拥有数据,并负责释放它。