Thread

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

A Thread is a chunk of code that can run in parallel with other threads.

Constructors

love.thread.newThreadCreates a new Thread from a Lua file or FileData object.Added since 0.7.0

Functions

Object:typeGets the type of the object as a string.
Object:typeOfChecks whether an object is of a certain type.
Thread:demandReceive a message from a thread. Wait for the message to exist before returning.Added since 0.7.0 Removed in 0.9.0
Thread:getGet a value.Added since 0.8.0 Removed in 0.9.0
Thread:getErrorRetrieves the error string from the thread.Added since 0.9.0
Thread:getKeysReturns the names of all messages as a table.Added since 0.8.0 Removed in 0.9.0
Thread:getNameGet the name of a thread.Added since 0.7.0 Removed in 0.9.0
Thread:isRunningReturns whether the thread is currently running.Added since 0.9.0
Thread:killForcefully terminate the thread.Added since 0.7.0 Removed in 0.8.0
Thread:peekReceive a message from a thread, but leave it in the message box.Added since 0.7.0 Removed in 0.9.0
Thread:receiveReceive a message from a thread.Added since 0.7.0 Removed in 0.8.0
Thread:sendSend a message.Added since 0.7.0 Removed in 0.8.0
Thread:setSet a value.Added since 0.8.0 Removed in 0.9.0
Thread:startStarts the thread.Added since 0.7.0
Thread:waitWait for a thread to finish.Added since 0.7.0

Supertypes

Notes

Removed in LÖVE 0.9.0
This method for retrieving errors has been replaced by Thread:getError and love.threaderror.

If a Lua error occurs in the thread, a message with the name "error" gets pushed to its message pool. Retrieve the message with Thread:get('error').

See Also

Other Languages

Personal tools