iup_thread.md

IupThread

Creates a thread element in IUP, which is not associated to any interface element. It is a very simple support to create and manage threads in a multithread environment.

It inherits from IupUser.

Creation

Ihandle* IupThread(void);

Returns: the identifier of the created element, or NULL if an error occurs.

Attributes

START (write-only, non-inheritable): starts the thread and calls the callback. Can be YES only. The thread exits when the callback is terminated.

EXIT (write-only, non-inheritable): exit the current thread. Value contains the exit code.

ISCURRENT (read-only, non-inheritable): returns if the started thread is the current thread.

YIELD (write-only, non-inheritable): yield execution to another thread. value is ignored.

JOIN (write-only, non-inheritable): Waits until thread finishes. value is ignored.

LOCK (non-inheritable): uses a mutex to create a lock to allow access to shared data. Can be YES or NO. When set to YES the mutex will be locked, when set to NO the mutex will be unlocked. It does not depend on if the thread is started or not.

Callbacks

THREAD_CB: Action generated when the thread is started. If this callback returns or does not exist, the thread is terminated.

int function(Ihandle* ih);

ih: identifier of the element that activated the event.

In WebAssembly uses Emscripten POSIX threads; under the Go binding the callback runs as a goroutine.