虚拟方法
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
释放返回的对象。
方法调用者负责获取返回的数据的所有权,并负责释放它。 |