Struct gio::FileInfo

source ·

#[repr(transparent)]
pub struct FileInfo { /* private fields */ }

Expand description

Functionality for manipulating basic metadata for files. FileInfo implements methods for getting information that all files should contain, and allows for manipulation of extended attributes.

See [GFileAttribute][gio-GFileAttribute] for more information on how GIO handles file attributes.

To obtain a FileInfo for a File, use FileExt::query_info() (or its async variant). To obtain a FileInfo for a file input or output stream, use FileInputStreamExt::query_info() or FileOutputStreamExt::query_info() (or their async variants).

To change the actual attributes of a file, you should then set the attribute in the FileInfo and call FileExt::set_attributes_from_info() or FileExt::set_attributes_async() on a GFile.

However, not all attributes can be changed in the file. For instance, the actual size of a file cannot be changed via set_size(). You may call FileExt::query_settable_attributes() and FileExt::query_writable_namespaces() to discover the settable attributes of a particular file at runtime.

The direct accessors, such as name(), are slightly more optimized than the generic attribute accessors, such as attribute_byte_string().This optimization will matter only if calling the API in a tight loop.

It is an error to call these accessors without specifying their required file attributes when creating the FileInfo. Use has_attribute() or list_attributes() to check what attributes are specified for a FileInfo.

FileAttributeMatcher allows for searching through a FileInfo for attributes.

Struct gio::FileInfo

Implementations§

impl FileInfo

pub fn modification_time(&self) -> SystemTime

pub fn set_modification_time(&self, mtime: SystemTime)

pub fn attribute_stringv(&self, attribute: &str) -> StrV

pub fn set_attribute_stringv(&self, attribute: &str, attr_value: impl IntoStrV)

impl FileInfo

pub fn new() -> FileInfo

pub fn clear_status(&self)

pub fn copy_into(&self, dest_info: &FileInfo)

pub fn dup(&self) -> FileInfo

pub fn access_date_time(&self) -> Option<DateTime>

pub fn attribute_as_string(&self, attribute: &str) -> Option<GString>

pub fn boolean(&self, attribute: &str) -> bool

pub fn attribute_byte_string(&self, attribute: &str) -> Option<GString>

pub fn attribute_file_path(&self, attribute: &str) -> Option<PathBuf>

pub fn attribute_int32(&self, attribute: &str) -> i32

pub fn attribute_int64(&self, attribute: &str) -> i64

pub fn attribute_object(&self, attribute: &str) -> Option<Object>

pub fn attribute_status(&self, attribute: &str) -> FileAttributeStatus

pub fn attribute_string(&self, attribute: &str) -> Option<GString>

pub fn attribute_type(&self, attribute: &str) -> FileAttributeType

pub fn attribute_uint32(&self, attribute: &str) -> u32

pub fn attribute_uint64(&self, attribute: &str) -> u64

pub fn content_type(&self) -> Option<GString>

pub fn creation_date_time(&self) -> Option<DateTime>

pub fn deletion_date(&self) -> Option<DateTime>

pub fn display_name(&self) -> GString

pub fn edit_name(&self) -> GString

pub fn etag(&self) -> Option<GString>

pub fn file_type(&self) -> FileType

pub fn icon(&self) -> Option<Icon>

pub fn is_backup(&self) -> bool

pub fn is_hidden(&self) -> bool

pub fn is_symlink(&self) -> bool

pub fn modification_date_time(&self) -> Option<DateTime>

pub fn name(&self) -> PathBuf

pub fn size(&self) -> i64

pub fn sort_order(&self) -> i32

pub fn symbolic_icon(&self) -> Option<Icon>

pub fn symlink_target(&self) -> Option<PathBuf>

pub fn has_attribute(&self, attribute: &str) -> bool

pub fn has_namespace(&self, name_space: &str) -> bool

pub fn list_attributes(&self, name_space: Option<&str>) -> Vec<GString>

pub fn remove_attribute(&self, attribute: &str)

pub fn set_access_date_time(&self, atime: &DateTime)

pub fn set_attribute_boolean(&self, attribute: &str, attr_value: bool)

pub fn set_attribute_byte_string(&self, attribute: &str, attr_value: &str)

pub fn set_attribute_file_path( &self, attribute: &str, attr_value: impl AsRef<Path> )

pub fn set_attribute_int32(&self, attribute: &str, attr_value: i32)

pub fn set_attribute_int64(&self, attribute: &str, attr_value: i64)

pub fn set_attribute_mask(&self, mask: &FileAttributeMatcher)

pub fn set_attribute_object( &self, attribute: &str, attr_value: &impl IsA<Object> )

pub fn set_attribute_status( &self, attribute: &str, status: FileAttributeStatus ) -> bool

pub fn set_attribute_string(&self, attribute: &str, attr_value: &str)

pub fn set_attribute_uint32(&self, attribute: &str, attr_value: u32)

pub fn set_attribute_uint64(&self, attribute: &str, attr_value: u64)

pub fn set_content_type(&self, content_type: &str)

pub fn set_creation_date_time(&self, creation_time: &DateTime)