Difference between revisions of "love.event.quit"
m |
m |
||
| (11 intermediate revisions by 6 users not shown) | |||
| Line 3: | Line 3: | ||
The quit event is a signal for the event handler to close LÖVE. It's possible to abort the exit process with the [[love.quit]] callback. | The quit event is a signal for the event handler to close LÖVE. It's possible to abort the exit process with the [[love.quit]] callback. | ||
| + | |||
| + | Equivalent to <code>love.event.push("quit", exitstatus)</code> | ||
== Function == | == Function == | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| − | love.event.quit( ) | + | love.event.quit( exitstatus ) |
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | + | {{New_feature|0.10.0| | |
| + | {{param|number|exitstatus (0)|The program exit status to use when closing the application.}} }} | ||
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
| + | === Notes === | ||
| + | On iOS, programmatically exiting the app (this includes call to <code>os.exit</code>) [https://developer.apple.com/library/archive/qa/qa1561/_index.html is not recommended] and may result your app being rejected from App Store. Thus, calling this variant will actually perform restart (see below). | ||
| + | |||
| + | == Function == | ||
| + | {{newin|[[0.10.2]]|102|type=variant}} | ||
| + | Restarts the game without relaunching the executable. This cleanly shuts down the main Lua state instance and creates a brand new one. | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | love.event.quit( "restart" ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|string|"restart"|Tells the default [[love.run]] to exit and restart the game without relaunching the executable.}} | ||
| + | === Returns === | ||
| + | Nothing. | ||
| + | |||
== Example == | == Example == | ||
<source lang="lua"> | <source lang="lua"> | ||
| Line 23: | Line 41: | ||
== See Also == | == See Also == | ||
* [[parent::love.event]] | * [[parent::love.event]] | ||
| + | * [[love.quit]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
| − | {{#set:Description=Exits the LÖVE program.}} | + | {{#set:Description=Exits or restarts the LÖVE program.}} |
{{#set:Since=080}} | {{#set:Since=080}} | ||
== Other Languages == | == Other Languages == | ||
{{i18n|love.event.quit}} | {{i18n|love.event.quit}} | ||
Latest revision as of 03:41, 11 July 2023
| Available since LÖVE 0.8.0 |
| This function is not supported in earlier versions. |
Adds the quit event to the queue.
The quit event is a signal for the event handler to close LÖVE. It's possible to abort the exit process with the love.quit callback.
Equivalent to love.event.push("quit", exitstatus)
Contents
Function
Synopsis
love.event.quit( exitstatus )
Arguments
number exitstatus (0)- The program exit status to use when closing the application.
Returns
Nothing.
Notes
On iOS, programmatically exiting the app (this includes call to os.exit) is not recommended and may result your app being rejected from App Store. Thus, calling this variant will actually perform restart (see below).
Function
| Available since LÖVE 0.10.2 |
| This variant is not supported in earlier versions. |
Restarts the game without relaunching the executable. This cleanly shuts down the main Lua state instance and creates a brand new one.
Synopsis
love.event.quit( "restart" )
Arguments
string "restart"- Tells the default love.run to exit and restart the game without relaunching the executable.
Returns
Nothing.
Example
function love.keypressed(k)
if k == 'escape' then
love.event.quit()
end
end
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info
