Gio.File.monitor (original) (raw)
Method
GioFilemonitor
since: 2.18
Declaration [src]
GFileMonitor*
g_file_monitor (
GFile* file,
GFileMonitorFlags flags,
GCancellable* cancellable,
GError** error
)
Description [src]
Obtains a file or directory monitor for the given file, depending on the type of the file.
If cancellable
is not NULL
, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED
will be returned.
Available since: 2.18
Parameters
flags
Type: GFileMonitorFlags
A set of GFileMonitorFlags
.
cancellable
Type: GCancellable
Optional GCancellable
object,NULL
to ignore.
The argument can be NULL. |
---|
The data is owned by the caller of the method. |
error
Type: GError **
The return location for a recoverable error.
The argument can be NULL. |
---|
If the return location is not NULL, then you must initialize it to a NULL GError*. |
The argument will be left initialized to NULL by the method if there are no errors. |
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it. |
Return value
Type: GFileMonitor
A GFileMonitor
for the given file
, or NULL
on error. Free the returned object with g_object_unref().
The caller of the method takes ownership of the returned data, and is responsible for freeing it.