summaryrefslogtreecommitdiff
path: root/meta/3rd/Defold/library/os.lua
blob: 9700724ae3689734dd9dca38aca08ebb1f3d0e09 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
---Lua os standard library
---Documentation for the Lua os standard library.
---From Lua 5.1 Reference Manual <https://www.lua.org/manual/5.1/>
---by Roberto Ierusalimschy, Luiz Henrique de Figueiredo, Waldemar Celes.
---Copyright © 2006-2012 Lua.org, PUC-Rio.
---Freely available under the terms of the Lua license <https://www.lua.org/license.html>.
---@class os
os = {}
---Returns an approximation of the amount in seconds of CPU time
---used by the program.
function os.clock() end

---Returns a string or a table containing date and time,
---formatted according to the given string format.
---If the time argument is present,
---this is the time to be formatted
---(see the os.time function for a description of this value).
---Otherwise, date formats the current time.
---If format starts with '!',
---then the date is formatted in Coordinated Universal Time.
---After this optional character,
---if format is the string "*t",
---then date returns a table with the following fields:
---year (four digits), month (1--12), day (1--31),
---hour (0--23), min (0--59), sec (0--61),
---wday (weekday, Sunday is 1),
---yday (day of the year),
---and isdst (daylight saving flag, a boolean).
---If format is not "*t",
---then date returns the date as a string,
---formatted according to the same rules as the C function strftime.
---When called without arguments,
---date returns a reasonable date and time representation that depends on
---the host system and on the current locale
---(that is, os.date() is equivalent to os.date("%c")).
---@param format ? # 
---@param time ? # 
function os.date(format, time) end

---Returns the number of seconds from time t1 to time t2.
---In POSIX, Windows, and some other systems,
---this value is exactly t2-t1.
---@param t2  # 
---@param t1  # 
function os.difftime(t2, t1) end

---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.
---@param command ? # 
function os.execute(command) end

---Calls the C function exit,
---with an optional code,
---to terminate the host program.
---The default value for code is the success code.
---Calling os.exit will do a hard exit which will not run
---the engine shutdown code. This may cause crashes on exit.
---The recommended way to terminate your game is by using
---the exit message which does a graceful shutdown.
---msg.post("@system:", "exit", {code = 0})
---@param code ? # 
function os.exit(code) end

---Returns the value of the process environment variable varname,
---or  nil if the variable is not defined.
---@param varname  # 
function os.getenv(varname) end

---Deletes the file or directory with the given name.
---Directories must be empty to be removed.
---If this function fails, it returns  nil,
---plus a string describing the error.
---@param filename  # 
function os.remove(filename) end

---Renames file or directory named oldname to newname.
---If this function fails, it returns  nil,
---plus a string describing the error.
---@param oldname  # 
---@param newname  # 
function os.rename(oldname, newname) end

---Sets the current locale of the program.
---locale is a string specifying a locale;
---category is an optional string describing which category to change:
---"all", "collate", "ctype",
---"monetary", "numeric", or "time";
---the default category is "all".
---The function returns the name of the new locale,
---or  nil if the request cannot be honored.
---If locale is the empty string,
---the current locale is set to an implementation-defined native locale.
---If locale is the string "C",
---the current locale is set to the standard C locale.
---When called with  nil as the first argument,
---this function only returns the name of the current locale
---for the given category.
---@param locale  # 
---@param category ? # 
function os.setlocale(locale, category) end

---Returns the current time when called without arguments,
---or a time representing the date and time specified by the given table.
---This table must have fields year, month, and day,
---and may have fields hour, min, sec, and isdst
---(for a description of these fields, see the os.date function).
---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.
---@param table ? # 
function os.time(table) end

---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.
---On some systems (POSIX),
---this function also creates a file with that name,
---to avoid security risks.
---(Someone else might create the file with wrong permissions
---in the time between getting the name and creating the file.)
---You still have to open the file to use it
---and to remove it (even if you do not use it).
---When possible,
---you may prefer to use io.tmpfile,
---which automatically removes the file when the program ends.
function os.tmpname() end




return os