note Help Needed
This wiki is the result of an ongoing community effort — thank you all for helping!
If you want to provide changes to this page then please click here.
fattrib
warning
This function was added in omp v1.1.0.2612 and will not work in earlier versions!
warning
This function starts with a lowercase letter.
Description
Set the file attributes.
| Name | Description |
|---|---|
| const filename[] | The name of the file. |
| timestamp = 0 | Time of the last modification of the file. When this parameter is set to zero, the time stamp of the file is not changed. |
| attrib = 0x0F | A bit mask with the new attributes of the file. When set to 0x0F, the attributes of the file are not changed. |
Returns
true on success, false on failure.
Examples
// Change file modification time to 'Thu Mar 07 2024 06:28:15'
if (fattrib("file.txt", 1709792895))
{
// Success
print("File attributes was set.");
}
else
{
// Error
print("The file \"file.txt\" does not exists, or can't set the attributes.");
}
Notes
tip
- The time is in number of seconds since midnight at 1 January 1970: the start of the UNIX system epoch.
- The file attributes are a bit mask.
- The meaning of each bit depends on the underlying file system (e.g. FAT, NTFS, etx2 and others).
Related Functions
- fopen: Open a file.
- fclose: Close a file.
- ftemp: Create a temporary file stream.
- fremove: Remove a file.
- fwrite: Write to a file.
- fputchar: Put a character in a file.
- fgetchar: Get a character from a file.
- fblockwrite: Write blocks of data into a file.
- fblockread: Read blocks of data from a file.
- fseek: Jump to a specific character in a file.
- flength: Get the file length.
- fexist: Check, if a file exists.
- fmatch: Check, if patterns with a file name matches.
- ftell: Get the current position in the file.
- fflush: Flush a file to disk (ensure all writes are complete).
- fstat: Return the size and the timestamp of a file.
- frename: Rename a file.
- fcopy: Copy a file.
- filecrc: Return the 32-bit CRC value of a file.
- diskfree: Returns the free disk space.
- fcreatedir: Create a directory.