ThreadWaitSignal (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Endless wait
Synchronizing the threads
Various

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ThreadWaitSignal (Function)

In french: ThreadAttendSignal

Locks the current thread until the reception of an event sent by another thread. This function simplifies the synchronization between threads without having to implement an advanced management of events.

Remark: This function is equivalent to EventWait with an automatic event for an event sent by ThreadSendSignal. Therefore, the event is automatically closed.

Reminders:

A thread is a process run in parallel of current application (main thread). This allows you to run a task in background task for example (backup, ...).
ThreadWaitSignal and ThreadSendSignal are used to synchronize the threads two by two.

Example

See additional examples

// Create an event
EventCreate("Let's go", eventManual, eventClose)
// Run a first thread
ThreadExecute("Thread1", threadNormal, "Thread_First")
// Locks the current thread until the event is obtained
ThreadWaitSignal()

// Run a second thread
ThreadExecute("Thread2", threadNormal, "Thread_Second")
// Locks the current thread until the event is obtained
ThreadWaitSignal()

// Modifies the event to run the threads
EventChange("Let's go", eventOpen)

//----------------------------------------------
PROCEDURE Thread_First()
Trace(dbgInfo(dbgProcess) + " - ThreadSendSignal(threadMain)")
ThreadSendSignal(threadMain)
EventWait("Let's go")
Trace(dbgInfo(dbgProcess) + " - Event received")

//--------------------------------------------
PROCEDURE Thread_Second()
Trace(dbgInfo(dbgProcess) + " - ThreadSendSignal(threadMain)")
ThreadSendSignal(threadMain)
EventWait("Let's go")
Trace(dbgInfo(dbgProcess) + " - Event received")

Syntax

<Result> = ThreadWaitSignal([<Maximum timeout>])

<Result>: Boolean

True if the current thread received an event,
False if the thread receives no event (the maximum duration is exceeded).

<Maximum timeout>: Optional integer, optional duration or optional constant

Maximum timeout in hundredths of a second.
If no event was received by the thread before the end of specified duration, <Result> is equal to False.
If this parameter is not specified or if it corresponds to the Infinite constant, the wait is infinite.
This parameter can correspond to:
an integer corresponding to the number of hundredths of a second,
a Duration variable,
Versions 23 and later
the direct indication of duration (1 s or 10 ms for example).
New in version 23
the direct indication of duration (1 s or 10 ms for example).
the direct indication of duration (1 s or 10 ms for example).

Remarks

Endless wait

You can end the execution of a thread even if it is locked in an endless wait for an event. To do so, use ThreadStop.

Synchronizing the threads

ThreadWaitSignal and ThreadSendSignal are used to synchronize the threads two by two. To synchronize several threads on the same event, the event management functions must be used:

EventCreate: Creates an event.
EventWait: Locks the current thread and waits for the event.
EventChange: Modifies the status of an event.
EventDestroy: Destroys an event.

Remark: The internal mechanisms for managing the queues and stacks allow you not to synchronize the threads (Enqueue and Dequeue for the queues, Push and Pop for the stacks).

Various

ThreadWaitSignal can be used in a process linked to a control (click code of a button for example): in this case, it is used in the main thread.

Component : wd250vm.dll