Difference between revisions of "love.quit"

m (Function: Better name for return value.)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{newin|[[0.7.0]]|070|type=callback}}
 
{{newin|[[0.7.0]]|070|type=callback}}
 
 
Callback function triggered when the game is closed.
 
Callback function triggered when the game is closed.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
r = love.quit()
+
abort = love.quit( )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
 
None.
 
None.
 
=== Returns ===
 
=== Returns ===
{{param|boolean|r|Abort quitting. If true, do not close the game.}}
+
{{param|boolean|abort|Abort quitting. If true, do not close the game.}}
 +
 
 
== Example ==
 
== Example ==
 +
This example shows how the return value of [[love.quit]] can be used to stop the closing of the game.
 
<source lang="lua">
 
<source lang="lua">
 +
local readyToQuit = false
 +
 
function love.quit()
 
function love.quit()
  --This will be printed to the console on quit
+
if not readyToQuit then
  print("Thanks for playing. Please play again soon!")
+
print("We are not ready to quit yet!")
 +
readyToQuit = true
 +
return true
 +
else
 +
print("Thanks for playing. Please play again soon!")
 +
return false
 +
end
 
end
 
end
 
</source>
 
</source>
 +
 
== See Also ==
 
== See Also ==
 
* [[parent::love]]
 
* [[parent::love]]
 +
* [[love.event.quit]]
 
[[Category:Callbacks]]
 
[[Category:Callbacks]]
 
{{#set:Description=Callback function triggered when the game is closed.}}
 
{{#set:Description=Callback function triggered when the game is closed.}}
 +
{{#set:Subcategory=General}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.quit}}
 
{{i18n|love.quit}}

Latest revision as of 14:37, 5 October 2021

Available since LÖVE 0.7.0
This callback is not supported in earlier versions.

Callback function triggered when the game is closed.

Function

Synopsis

abort = love.quit( )

Arguments

None.

Returns

boolean abort
Abort quitting. If true, do not close the game.

Example

This example shows how the return value of love.quit can be used to stop the closing of the game.

local readyToQuit = false

function love.quit()
	if not readyToQuit then
		print("We are not ready to quit yet!")
		readyToQuit = true
		return true
	else
		print("Thanks for playing. Please play again soon!")
		return false
	end
end

See Also


Other Languages