方法
GioFileread
声明 [源码]
GFileInputStream*
g_file_read (
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()释放返回的对象。
方法调用者负责返回数据的拥有权,并负责释放它。 |