Gio.File::query_filesystem_info

function vfunc_query_filesystem_info(attributes: String, cancellable: Gio.Cancellable): Gio.FileInfo {
}
  

Similar to Gio.File.prototype.query_info, but obtains information about the filesystem the file is on, rather than the file itself. For instance the amount of space available and the type of the filesystem.

The attributes value is a string that specifies the 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 "filesystem::*" means all attributes in the filesystem namespace. The standard namespace for filesystem attributes is "filesystem". Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).

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 Gio.IOErrorEnum.cancelled will be returned.

If the file does not exist, the Gio.IOErrorEnum.not_found error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on.

attributes

an attribute query string

cancellable

optional Gio.Cancellable object, null to ignore

Returns

a Gio.FileInfo or null if there was an error. Free the returned object with GObject.Object.prototype.unref.