![]() |
![]() |
![]() |
MateVFS - Filesystem Abstraction library | ![]() |
---|---|---|---|---|
Top | Description |
Getting and Setting File InformationGetting and Setting File Information — Convenient high-level abstraction for obtaining and setting file information, including ACLs. |
MateVFSResult mate_vfs_get_file_info (const gchar *text_uri
,MateVFSFileInfo *info
,MateVFSFileInfoOptions options
); MateVFSResult mate_vfs_get_file_info_uri (MateVFSURI *uri
,MateVFSFileInfo *info
,MateVFSFileInfoOptions options
); MateVFSResult mate_vfs_get_file_info_from_handle (MateVFSHandle *handle
,MateVFSFileInfo *info
,MateVFSFileInfoOptions options
); MateVFSResult mate_vfs_set_file_info_uri (MateVFSURI *uri
,MateVFSFileInfo *info
,MateVFSSetFileInfoMask mask
); MateVFSResult mate_vfs_set_file_info (const gchar *text_uri
,MateVFSFileInfo *info
,MateVFSSetFileInfoMask mask
);
Applications can use the mate_vfs_get_file_info()
family of operations to
retrieve file information, as this operation can be quite costly in
terms of time (specilly when sniffing the MIME type) applications can
specify which information need at any time, reducing the performance
impact.
All of these operations use a MateVFSFileInfo data structure that holds the file information, there are several methods that can be used to manipulate this information. See MateVFSFileInfo for more information.
MateVFSResult mate_vfs_get_file_info (const gchar *text_uri
,MateVFSFileInfo *info
,MateVFSFileInfoOptions options
);
Retrieve information about text_uri
. The information will be stored in
info
.
|
uri of the file for which information will be retrieved. |
|
pointer to a MateVFSFileInfo object that will hold the information for the file on return. |
|
options for retrieving file information. |
Returns : |
an integer representing the result of the operation. |
MateVFSResult mate_vfs_get_file_info_uri (MateVFSURI *uri
,MateVFSFileInfo *info
,MateVFSFileInfoOptions options
);
Retrieve information about text_uri
. The information will be stored in
info
.
|
uri of the file for which information will be retrieved. |
|
pointer to a MateVFSFileInfo object that will hold the information for the file on return. |
|
options for retrieving file information. |
Returns : |
an integer representing the result of the operation. |
MateVFSResult mate_vfs_get_file_info_from_handle (MateVFSHandle *handle
,MateVFSFileInfo *info
,MateVFSFileInfoOptions options
);
Retrieve information about an open file. The information will be stored in
info
.
|
handle of the file for which information must be retrieved. |
|
pointer to a MateVFSFileInfo object that will hold the information for the file on return. |
|
options for retrieving file information. |
Returns : |
an integer representing the result of the operation. |
MateVFSResult mate_vfs_set_file_info_uri (MateVFSURI *uri
,MateVFSFileInfo *info
,MateVFSSetFileInfoMask mask
);
Set file information for uri
; only the information for which the
corresponding bit in mask
is set is actually modified.
info
's valid_fields
is not required to contain the
MateVFSFileInfoFields corresponding to the specified
MateVFSSetFileInfoMask fields of mask
. It
is assumed that the info
fields referenced by mask
are valid.
|
a uri. |
|
information that must be set for the file. |
|
bit mask representing which fields of info need to be set.
|
Returns : |
an integer representing the result of the operation. |
MateVFSResult mate_vfs_set_file_info (const gchar *text_uri
,MateVFSFileInfo *info
,MateVFSSetFileInfoMask mask
);
Set file information for uri
; only the information for which the
corresponding bit in mask
is set is actually modified.
info
's valid_fields
is not required to contain the
MateVFSFileInfoFields corresponding to the specified
MateVFSSetFileInfoMask fields of mask
. It
is assumed that the info
fields referenced by mask
are valid.
|
string representing the file location. |
|
information that must be set for the file. |
|
bit mask representing which fields of info need to be set.
|
Returns : |
an integer representing the result of the operation. |