X Threads

Supported platforms:
Available since: 2018.12

Description

The Threads plugin provides the ability to run Lua code in separate threads, taking advantage of multiple cores where available.

Example

Simple example of getting result from thread.

require "Threads"
local thread = Thread.new()
thread:setFunction(function() 
  local a
  for i = 1, 10000000 do 
    a += 1
  end 
  return i 
end)
thread:execute()
local ok = false
while not ok do
  ok = thread:getResult()
end
print("woot!")

Methods Thread.new Creates a new thread object. Thread:setFunction Sets Lua function that thread will execute. Thread:execute Starts/executes our thread Thread:resume Resumes a thread that has been yielded. Thread.yield Pauses executions of thread (only a valid call inside thread function). Thread:status Returns current status of the thread. Thread:getNumLogicalCores Returns number of logical cores on host machine. Thread:requestTermination Sets a flag to terminate thread. Thread:sendData Sends data for retrieval by main thread (only a valid call inside thread function). Thread:fetchData Returns any data sent by thread sendData call. Thread:getResults Get any results from thread.

Events none Constants none