Difference between revisions of "Channel:supply"

(Created page with "{{newin|0.9.0|090|type=function}} Send a message to the thread channel and wait for a thread to accept it. The name of the message can be any string. The value of the messag...")
 
m
 
(12 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=function}}
 
{{newin|[[0.9.0]]|090|type=function}}
Send a message to the thread channel and wait for a thread to accept it.
+
Send a message to the thread Channel and wait for a thread to accept it.
  
The name of the message can be any string. The value of the message can be a boolean, string, number or a LÖVE userdata. Foreign userdata (Lua's files, LuaSocket, ...), functions or tables are not supported.
+
See [[Variant]] for the list of supported types.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Channel:push( name , value )
+
success = Channel:supply( value )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|string|name|The name of the message.}}
+
{{param|Variant|value|The contents of the message.}}
{{param|string|name|The contents of the message.}}
 
 
=== Returns ===
 
=== Returns ===
None.
+
{{New feature|11.0|
 +
{{param|boolean|success|Whether the message was successfully supplied (always <code>true</code>).}}
 +
|110}}
 +
 
 +
== Function ==
 +
{{newin|[[11.0]]|110|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
success = Channel:supply( value, timeout )
 +
</source>
 +
=== Arguments ===
 +
{{param|Variant|value|The contents of the message.}}
 +
{{param|number|timeout|The maximum amount of time to wait, in seconds.}}
 +
=== Returns ===
 +
{{param|boolean|success|Whether the message was successfully supplied before the timeout expired.}}
 
== See Also ==
 
== See Also ==
 
* [[parent::Channel]]
 
* [[parent::Channel]]
 +
* [[Channel:demand]]
 +
* [[Channel:push]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Send a message to a named thread channel and wait for a thread to accept it.}}
+
{{#set:Description=Send a message to a thread Channel and wait for a thread to accept it.}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|Channel:supply}}
 
{{i18n|Channel:supply}}

Latest revision as of 11:06, 7 July 2021

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

Send a message to the thread Channel and wait for a thread to accept it.

See Variant for the list of supported types.

Function

Synopsis

success = Channel:supply( value )

Arguments

Variant value
The contents of the message.

Returns

Available since LÖVE 11.0
boolean success
Whether the message was successfully supplied (always true).


Function

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

Synopsis

success = Channel:supply( value, timeout )

Arguments

Variant value
The contents of the message.
number timeout
The maximum amount of time to wait, in seconds.

Returns

boolean success
Whether the message was successfully supplied before the timeout expired.

See Also

Other Languages