Difference between revisions of "love.event.quit"

m (iOS notice.)
Line 16: 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 ==

Revision as of 06:41, 10 May 2021

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