Operating System Facilities.
Static methods
staticclock():Float
Returns an approximation of the amount in seconds of CPU time used by the program.
staticdate():DateType
staticdate(format:String, time:Time):DateType
staticdate(format:String):DateType
staticdifftime(t2:Time, t1:Time):Float
Returns the number of seconds from time t1
to time t2
.
In POSIX, Windows, and some other systems, this value is exactly t2-t1
.
staticexecute(?command:String):Dynamic
This function is equivalent to the C function system. It passes command to be executed by an operating system shell. It returns a status code, which is system-dependent. If command is absent, then it returns nonzero if a shell is available and zero otherwise.
staticexit(code:Int):Int
Calls the C function exit, with an optional code, to terminate the host program. The default value for code is the success code.
staticgetenv(varname:String):String
Returns the value of the process environment variable varname
, or null
if the variable is not defined.
staticremove(filename:String):OsSuccess
Deletes the file or directory with the given name. Directories must be empty to be removed.
staticrename(oldname:String, newname:String):OsSuccess
Renames file or directory named oldname
to newname
.
staticsetlocale(locale:String, ?category:LocaleCategory):String
Sets the current locale of the program.
statictime(?arg:TimeParam):Time
Returns the current time when called without arguments, or a time representing the date and time specified by the given table.
The returned value is a number, whose meaning depends on your system. In POSIX, Windows, and some other systems, this number counts the number of seconds since some given start time (the "epoch"). In other systems, the meaning is not specified, and the number returned by time can be used only as an argument to date and difftime.
statictmpname():String
Returns a string with a file name that can be used for a temporary file. The file must be explicitly opened before its use and explicitly removed when no longer needed.
When possible, you may prefer to use Io.tmpfile
, which automatically
removes the file when the program ends.