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.
fstat
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
Return the size and the timestamp of a file.
| Name | Description |
|---|---|
| const filename[] | The name of the file. |
| &size | If the function is successful, this param-eter holds the size of the file on return. |
| ×tamp | If the function is successful, this parameter holds the time of the last modification of the file on return. |
| &attrib | If the function is successful, this parameter holds the file attributes. |
| &inode | If the function is successful, this parameter holds inode number of the file. An inode number is a number that uniquely identifies a file, and it usually indicates the physical position of (the start of) the file on the disk or memory card. |
Returns
true - The function was executed successfully.
false - The function failed to execute. (File doesn't exist)
Examples
new
size,
timestamp,
attrib,
inode;
if (fstat("file.txt", size, timestamp, attrib, inode))
{
// Success
printf("size = %d, timestamp = %d, attrib = %d, inode = %d", size, timestamp, attrib, inode);
}
else
{
// Error
print("The file \"file.txt\" does not exists, or can't be opened.");
}
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).
- frename: Rename a file.
- fcopy: Copy a file.
- filecrc: Return the 32-bit CRC value of a file.
- diskfree: Returns the free disk space.
- fattrib: Set the file attributes.
- fcreatedir: Create a directory.