THREADCALL


Starts a user-defined procedure with parameters in a separate execution thread


Syntax:
function Threadcall subname([paramlist]) as any ptr

Usage:
threadid = Threadcall subname([paramlist])

Parameters:
subname
The name of a subroutine
paramlist
A list of parameters to pass to the subroutine, as with a normal sub call.

Return Value:
Threadcall returns an any ptr handle to the thread created, or the null pointer (0) on failure.

Description:
Like Threadcreate, Threadcall creates a thread which runs at the same time as the code calling it. By placing "Threadcall" before almost any normal call to sub, the sub is called inside of a new thread and returns a pointer to that thread.

Using Threadcall is simpler method of creating threads, and allows data to be passed to the thread without global variables or pointers which are not type safe. However, Threadcreate is more efficient and should be used for programs creating a large number of threads.

While most subroutines are supported, the following types of subroutines may not be called:
  • Subroutines using variable arguments.
  • Subroutines with unions which are passed as arguments.
  • Subroutines with user types containing unions, arrays, strings, or bitfields which are passed as arguments.

When using Threadcall, parenthesis around the parameter list are required unless the subroutine has no parameters.

WARNING: Presently when Threadcall involves to pass parameters to the thread, there is no guarantee that the corresponding data are still maintained after the end of the Threadcall statement and this until the thread is launched. That can cause bad behavior.

Examples:
'' Threading using "ThreadCall"

Sub thread( id As String, tlock As Any Ptr, count As Integer )
    For i As Integer = 1 To count
        MutexLock tlock
        Print "thread " & id;
        Locate , 20
        Print i & "/" & count
        MutexUnlock tlock
    Next
End Sub

Dim tlock As Any Ptr = MutexCreate()
Dim a As Any Ptr = ThreadCall thread("A", tlock, 6)
Dim b As Any Ptr = ThreadCall thread("B", tlock, 4)
ThreadWait a
ThreadWait b
MutexDestroy tlock
Print "All done (and without Dim Shared!)"


Dialect Differences:
Platform Differences:
Differences from QB:
See also:
Back to Threading Support Functions
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki



sf.net phatcode