Threaddetach

Home › Threading Support Functions › ThreadDetach

ThreadDetach

Releases a thread handle without waiting; the thread runs on to its end.

Syntax

Declare Sub ThreadDetach ( ByVal id As Any Ptr )

Parameters

• id

Description

ThreadDetach releases resources associated with the thread handle returned by ThreadCreate or ThreadCall. The thread handle will be destroyed by ThreadDetach and cannot be used anymore. Unlike ThreadWait, ThreadDetach does not wait for the thread to finish and thread execution continues independently. Any allocated resources will be freed once the thread exits.

In order to avoid memory leaks, the safe way to end a thread is to always signal to it that it must end, and then call ThreadWait on that thread except if ThreadDetach has previously been called.

Note: As ThreadDetach destroys the thread handle, ThreadWait can no longer check for the thread ending, and even the use of ThreadWait becomes unpredictable (may crash the program). The use between ThreadWait and ThreadDetach must be exclusive. But mutexes and conditional variables can also be used with detached threads.

Remarks

Usage

#include "fbthread.bi"

ThreadDetach( id )

Dialect Differences

• Threading is not allowed in the -lang qb dialect.

Platform Differences

• ThreadDetach is not available with the DOS version of FreeBASIC, because multithreading is not supported by DOS kernel nor the used extender.

Differences from QB

• New to FreeBASIC

See also

• ThreadWait
• ThreadCreate

Examples

#include "fbthread.bi"

Sub mythread( ByVal param As Any Ptr )

    Print "hi!"

End Sub

Dim As Any Ptr thread = ThreadCreate( @mythread )

ThreadDetach( thread )

'' or

ThreadDetach( ThreadCreate( @mythread ) )

Sleep

---

Category: Threading Support Functions
Kind: sub

---

Reproduced from the FreeBASIC Wiki Manual under the GNU Free Documentation License 1.3 — with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. Copyright © the FreeBASIC project and wiki contributors. See License.