This function can be used to change one or multiple attributes of a
file or directory. This includes information such as the file time,
protection flags, and more, depending on the host file system.
The file (or directory) whose attributes you want to change must be
passed as parameter f$. The second parameter is a table which contains
all attributes you want to modify. The following fields can be set
in the table:
Flags:
-
Use this field to change the protection flags of the file or directory.
Set this field to a combination of protection flags or to
#FILEATTR_NORMAL
to reset all protection flags. See Protection flags for details.
Time:
-
Use this field to change the time stamp of the file or directory. This
field can be used to change the time when the file was last changed.
You need to set this field to a string in the format dd-mmm-yyyy
hh:mm:ss. E.g.: 08-Nov-2004 14:32:13.
LastAccessTime:
-
Use this field to modify the time the file or directory was last
accessed. The string you specify here must be in the format dd-mmm-yyyy
hh:mm:ss. This attribute is not supported on AmigaOS.
CreationTime:
-
Use this field to modify the creation time of the file or directory.
The string you specify here must be in the format dd-mmm-yyyy
hh:mm:ss. This attributed is only supported on Windows.
Comment:
-
Use this field to change the comment of a file. This is only supported
by the Amiga versions.
Adapter:
-
This tag allows you to specify one or more filesystem adapters that should be asked
to handle the operation. This must be set to a string containing the name(s) of one or
more adapter(s). Defaults to the adapter set using SetDefaultAdapter().
See Loaders and adapters for details. (V10.0)
UserTags:
-
This tag can be used to specify additional data that should be passed to filesystem
adapters. If you use this tag, you must set it to a table of key-value pairs
that contain the additional data that should be passed to plugins. See User tags for details. (V10.0)
Note that Android content URIs are currently unsupported by this
function. See Working with Android URIs for details.