方法
Gio文件monitor_file
声明 [源代码]
GFileMonitor*
g_file_monitor_file (
GFile* file,
GFileMonitorFlags flags,
GCancellable* cancellable,
GError** error
)
描述 [源代码]
获取给定文件的文件监视器。如果不存在文件通知机制,则将使用常规轮询来监视文件。
如果cancellable
不是NULL
,则可以通过触发另一个线程的可取消对象来取消操作。如果操作已取消,则将返回错误G_IO_ERROR_CANCELLED
。
如果flags
包含G_FILE_MONITOR_WATCH_HARD_LINKS
,则监视器还将尝试报告对文件通过另一个文件名(即,硬链接)所做的更改。没有此标志,您只能依赖通过file
中包含的文件名所做的更改来报告。使用此标志可能会增加资源使用量,并且根据GFileMonitor
后端和/或文件系统类型,可能没有任何影响。
参数
flags
-
一组
GFileMonitorFlags
。 cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,为NULL
时忽略。该参数可以为 NULL
。数据由方法调用者持有。 error
-
类型:
GError **
用于可恢复错误的返回位置。
该参数可以为 NULL
。如果返回位置不是 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,方法将保留参数初始化为 NULL
。在发生错误的情况下,该参数将设置为一个新的 GError
;调用者将获取数据的所有权,并负责释放它。
返回值
类型: GFileMonitor
给定file
的GFileMonitor
,或者在错误时为NULL
。使用g_object_unref()释放返回的对象。
方法的调用者获取返回数据的所有权,并负责释放它。 |