A unit of execution in a process.
Note: Breakpoints won't break on code if it's running in a thread. This is a current limitation of the GDScript debugger.
get_id ( ) const
is_alive ( ) const
is_started ( ) const
wait_to_finish ( )
PRIORITY_LOW = 0 --- A thread running with lower priority than normally.
PRIORITY_NORMAL = 1 --- A thread with a standard priority.
PRIORITY_HIGH = 2 --- A thread running with higher priority than normally.
String get_id ( ) const
Returns the current
Thread's ID, uniquely identifying it among all threads. If the
Thread is not running this returns an empty string.
bool is_alive ( ) const
true if this
Thread is currently running. This is useful for determining if wait_to_finish can be called without blocking the calling thread.
To check if a
Thread is joinable, use is_started.
bool is_started ( ) const
Starts a new
Thread that calls
userdata passed as an argument. Even if no userdata is passed,
callable must accept one argument and it will be null. The
priority of the
Thread can be changed by passing a value from the Priority enum.
Variant wait_to_finish ( )
Should either be used when you want to retrieve the value returned from the method called by the
Thread or before freeing the instance that contains the
To determine if this can be called without blocking the calling thread, check if is_alive is
Note: After the
Thread finishes joining it will be disposed. If you want to use it again you will have to create a new instance of it.