Difference between revisions of "love.event.quit"

m (iOS notice.)
m (Fixed typo)
Line 43: 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}}

Revision as of 15:50, 19 August 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