setFileModificationTime()
This function sets/changes the last modification date and time of a file.
Synopsis
int setFileModificationTime( string PathFilename, time mtime);
Parameters
| Parameter | Meaning |
|---|---|
| PathFilename | Path and file name, for example, "C:/Dokumentation/Test.bmp". |
| mtime | Date and time that shall be set. Therefore use the makeTime() function . |
Return value
Return 0, if date and time were set.
Return -1, if an error occurs.
Description
This function sets/changes the last modification date and time of a file.
Under Linux negative times can be used but not under Windows. If, for example, the time (time) -1 is set, the time 1970.01.01 01:00:00.000000000 is set under Windows. Under Linux again the time (time)-1 seconds meaning 1970.01.01 00:59:59.000000000 is set.
Example
The following example returns the modification date and time of the file. In order to execute the example, the files have to exist and have to be located in the correct directory.
main()
{
time time;
string test
time modTime;
test = "C:/Dokumentation/Test.bmp";
time = getFileModificationTime(test);
DebugN("Modificated:", test, time);
modTime = makeTime(2008,12,24,14,21,23);
setFileModificationTime(test, modTime);
}Assignment
File functions
Availability
CTRL
