IupThread (since 3.28)

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.

In non Windows systems uses the pthreads library.

Creation

Ihandle* IupThread(void); [in C]
iup.thread{} -> (ih: ihandle) [in Lua]
thread() [in LED]

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 depends 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); [in C]
ih:thread_cb() -> (ret: number) [in Lua]

ih: identifier of the element that activated the event.