Difference between revisions of "love.event.quit"

m (remove the word "callback" from see also (looks weird))
m
 
(6 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
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.
  
== Function ==
+
Equivalent to <code>love.event.push("quit", exitstatus)</code>
=== Synopsis ===
 
<source lang="lua">
 
love.event.quit( )
 
</source>
 
=== Arguments ===
 
None.
 
=== Returns ===
 
Nothing.
 
  
 
== Function ==
 
== Function ==
{{newin|[[0.10.0]]|100|type=variant}}
 
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Line 21: Line 12:
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|number|exitstatus (0)|The program exit status to use when closing the application.}}
+
{{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 ==
 
== Function ==
Line 49: Line 43:
 
* [[love.quit]]
 
* [[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)

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