Difference between revisions of "Channel:demand"

m
m (0.11.0 -> 11.0)
(4 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
Retrieves the value of a Channel message and removes it from the message queue.
 
Retrieves the value of a Channel message and removes it from the message queue.
  
The value of the message can be a boolean, string, number, LÖVE userdata, or a simple flat table. It waits until a message is in the queue then returns the message value.
+
It waits until a message is in the queue then returns the message value.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 11: Line 11:
 
None.
 
None.
 
=== Returns ===
 
=== Returns ===
{{param|boolean, number, string, LÖVE userdata, or flat table|value|The contents of the message.}}
+
{{param|Variant|value|The contents of the message.}}
 +
 
 +
== Function ==
 +
{{newin|[[11.0]]|110|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
value = Channel:demand( timeout )
 +
</source>
 +
=== Arguments ===
 +
{{param|number|timeout|The maximum amount of time to wait.}}
 +
=== Returns ===
 +
{{param|Variant|value|The contents of the message or nil if the timeout expired.}}
 
== See Also ==
 
== See Also ==
 
* [[parent::Channel]]
 
* [[parent::Channel]]
 +
* [[Channel:supply]]
 
* [[Channel:pop]]
 
* [[Channel:pop]]
* [[Channel:push]]
 
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{#set:Description=Wait for and retrieve the value of a Channel message.}}
 
{{#set:Description=Wait for and retrieve the value of a Channel message.}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|Channel:demand}}
 
{{i18n|Channel:demand}}

Revision as of 14:19, 22 December 2018

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

Retrieves the value of a Channel message and removes it from the message queue.

It waits until a message is in the queue then returns the message value.

Function

Synopsis

value = Channel:demand( )

Arguments

None.

Returns

Variant value
The contents of the message.

Function

Available since LÖVE 11.0
This variant is not supported in earlier versions.

Synopsis

value = Channel:demand( timeout )

Arguments

number timeout
The maximum amount of time to wait.

Returns

Variant value
The contents of the message or nil if the timeout expired.

See Also

Other Languages