虚拟方法

GioFileread_fn

声明 [源]

GFileInputStream*
read_fn (
  GFile* file,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

打开文件以进行读取。结果是可用于读取文件内容的 GFileInputStream

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

如果文件不存在,将返回错误 G_IO_ERROR_NOT_FOUND。如果文件是目录,将返回错误 G_IO_ERROR_IS_DIRECTORY。也可能有其他错误,具体取决于文件所在的文件系统类型。

参数

cancellable

类型: GCancellable

GCancellable

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

类型: GError **

可恢复错误的返回位置。

该参数可以为 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULL GError*
如果没有错误,虚拟函数会将参数保留初始化为 NULL
如果出错,参数将设置为一个新的 GError;调用者将获得数据的所有权,并负责释放它。

返回值

类型: GFileInputStream

GFileInputStream 或出错时为 NULL。用 g_object_unref 释放返回的对象。

方法调用者负责获取返回的数据的所有权,并负责释放它。