Help Center
Help CenterFreeBASIC

CondDestroysub

Destroys a multi-threading conditional variable when it is no more needed

Syntax

Declare Sub CondDestroy ( ByVal handle As Any Ptr )

Parameters

NameDescription
handleThe handle of a conditional variable to destroy.

Description


Once the conditional is CondCreated and the threads are started, one of more of them (including the implicit main thread executing main program) can be set to CondWait for the conditional, they will be stopped until some other thread CondSignals that the waiting thread can restart. CondBroadcast can be used to restart all threads waiting for the conditional. At the end of the program CondDestroy must be used to avoid leaking resources in the OS.

Conddestroy destroys a condition variable, freeing the resources it might hold. No threads must be waiting on the condition variable on entrance to Conddestroy.

Remarks

Usage


CondDestroy ( handle )

Platform Differences


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

Dialect Differences


Differences from QB


  • New to FreeBASIC

See also


Example


See CondCreate, CondWait, CondSignal, and CondBroadcast

Reference

  • Documented in KeyPgCondDestroy.html