Difference between revisions of "love.event.push"

(Fixed how the parameters work from 0.10 onwards, mentioned it in the main text.)
(Specify what types of arguments are supported for the events)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Adds an event to the event queue.<br>From 0.10.0 onwards, you may pass an arbitrary amount of arguments with this function, though the default callbacks don't ever use more than six.
+
{{newin|[[0.6.0]]|060|type=function}}
 +
Adds an event to the event queue.
 +
 
 +
See [[Variant]] for the list of supported types for the arguments.
 +
 
 +
From [[0.10.0]] onwards, you may pass an arbitrary amount of arguments with this function, though the default callbacks don't ever use more than six.
 +
 
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 21: Line 27:
 
Nothing.
 
Nothing.
 
== Examples ==
 
== Examples ==
=== Quitting a game in 0.8.0 ===
+
{{New_feature|0.8.0|
 
<source lang="lua">
 
<source lang="lua">
 
function love.keypressed(k)
 
function love.keypressed(k)
Line 28: Line 34:
 
end
 
end
 
end
 
end
</source>
+
</source>}}
=== Quitting a game in 0.7.2 ===
+
{{Removed_new_feature|0.6.0|0.7.2|
 
<source lang="lua">
 
<source lang="lua">
 
function love.keypressed(k)
 
function love.keypressed(k)
Line 36: Line 42:
 
end
 
end
 
end
 
end
</source>
+
</source>}}
 
== See Also ==
 
== See Also ==
 
* [[parent::love.event]]
 
* [[parent::love.event]]

Latest revision as of 13:17, 17 July 2020

Available since LÖVE 0.6.0
This function is not supported in earlier versions.

Adds an event to the event queue.

See Variant for the list of supported types for the arguments.

From 0.10.0 onwards, you may pass an arbitrary amount of arguments with this function, though the default callbacks don't ever use more than six.

Function

Synopsis

love.event.push( n, a, b, c, d, e, f, ... )

Arguments

Event n
The name of the event.
Variant a (nil)
First event argument.
Variant b (nil)
Second event argument.
Variant c (nil)
Third event argument.
Available since LÖVE 0.8.0
Variant d (nil)
Fourth event argument.


Available since LÖVE 0.10.0
Variant e (nil)
Fifth event argument.
Variant f (nil)
Sixth event argument.
Variant ... (nil)
Further event arguments may follow.

Returns

Nothing.

Examples

Available since LÖVE 0.8.0
function love.keypressed(k)
	if k == 'escape' then
		love.event.push('quit') -- Quit the game.
	end	
end


Available since LÖVE 0.6.0 and removed in LÖVE 0.7.2
function love.keypressed(k)
	if k == 'escape' then
		love.event.push('q') -- Quit the game.
	end	
end

See Also


Other Languages