GFileInfo* g_file_query_info ( GFile* file, const char* attributes, GFileQueryInfoFlags flags, GCancellable* cancellable, GError** error )
Gets the requested information about specified
The result is a
GFileInfo object that contains key-value
attributes (such as the type or size of the file).
attributes value is a string that specifies the file
attributes that should be gathered. It is not an error if
it’s not possible to read a particular requested attribute
from a file - it just won’t be set.
attributes should be a
comma-separated list of attributes or attribute wildcards.
The wildcard “” means all attributes, and a wildcard like
“standard::” means all attributes in the standard namespace.
An example attribute query be “standard::*,owner::user”.
The standard attributes are available as defines, like
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.
For symlinks, normally the information about the target of the
symlink is returned, rather than information about the symlink
itself. However if you pass
flags the information about the symlink itself will be returned.
Also, for symlinks that point to non-existing files the information
about the symlink itself will be returned.
If the file does not exist, the
G_IO_ERROR_NOT_FOUND error will be
returned. Other errors are possible too, and depend on what kind of
filesystem the file is on.
An attribute query string.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
A set of
The argument can be
The data is owned by the caller of the method.
The return location for a recoverable error.
The argument can be
If the return location is not
NULL, then you must initialize it to a
The argument will be left initialized to
NULLby 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.
GFileInfo for the given
on error. Free the returned object with g_object_unref().
|The caller of the method takes ownership of the data, and is responsible for freeing it.|