gFileQueryInfo {RGtk2} | R Documentation

## gFileQueryInfo

### Description

Gets the requested information about specified `file`. The result is a `GFileInfo` object that contains key-value attributes (such as the type or size of the file).

### Usage

    gFileQueryInfo(object, attributes, flags = "G_FILE_QUERY_INFO_NONE",
        cancellable = NULL, .errwarn = TRUE)

### Arguments

``object`` | input `GFile`.
``attributes`` | an attribute query string.
``flags`` | a set of `GFileQueryInfoFlags`.
``cancellable`` | optional `GCancellable` object, `NULL` to ignore.
`.errwarn` | Whether to issue a warning on error or fail silently

### Details

The `attribute` 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. `attribute` should be a comma-separated list of attribute 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 `G_FILE_ATTRIBUTE_STANDARD_NAME`.

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.

For symlinks, normally the information about the target of the symlink is returned, rather than information about the symlink itself. However if you pass `G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS` in `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.

### Value

A list containing the following elements:

`retval` | [`GFileInfo`] a `GFileInfo` for the given `file`, or `NULL` on error.
``error`` | a `GError`.

### Author(s)

Derived by RGtkGen from GTK+ documentation

[Package RGtk2 version 2.20.40 Index]