Difference between revisions of "love.event.quit"

m (Explained that love.event.quit is just a shortcut for pushing the quit event)
m
 
(3 intermediate revisions by 3 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 ===
Equivalent to love.event.push("quit", exitstatus)
 
 
<source lang="lua">
 
<source lang="lua">
 
love.event.quit( exitstatus )
 
love.event.quit( exitstatus )
Line 15: Line 16:
 
=== 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 ==
 
== Function ==
Line 40: Line 43:
 
* [[love.quit]]
 
* [[love.quit]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Exits or restart 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)

Function

Synopsis

love.event.quit( exitstatus )

Arguments

Available since LÖVE 0.10.0
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