{{newin|[[0.10.0]]|100|type=function}}
Executes the specified function atomically with respect to this Channel.

Calling multiple methods in a row on the same Channel is often useful. However if multiple [[Thread]]s are calling this Channel's methods at the same time, the different calls on each Thread might end up interleaved (e.g. one or more of the second thread's calls may happen in between the first thread's calls.)

This method avoids that issue by making sure the Thread calling the method has exclusive access to the Channel until the specified function has returned.

{{notice|Long-running or otherwise expensive code should be avoided in the function given to this method.}}
== Function ==
=== Synopsis ===
<source lang="lua">
ret1, ... = Channel:performAtomic( func, arg1, ... )
</source>
=== Arguments ===
{{param|function|func|The function to call, the form of <code>function(channel, arg1, arg2, ...) end</code>. The Channel is passed as the first argument to the function when it is called.}}
{{param|any|arg1|Additional arguments that the given function will receive when it is called.}}
{{param|any|...|Additional arguments that the given function will receive when it is called.}}
=== Returns ===
{{param|any|ret1|The first return value of the given function (if any.)}}
{{param|any|...|Any other return values.}}
== Examples ==
=== Re-set a Channel's contents to only have a single value ===
<source lang="lua">
local function setChannel(channel, value)
    channel:clear()
    channel:push(value)
end

local c = love.thread.getChannel("MyChannel")
c:performAtomic(setChannel, "hello world")
</source>

== See Also ==
* [[parent::Channel]]
* [[Thread]]
[[Category:Functions]]
{{#set:Description=Executes the specified function atomically with respect to this Channel.}}

== Other Languages ==
{{i18n|Channel:performAtomic}}