ucNewThread

See Also: ucReleaseItem, Thread Handling

Allocates a new thread, and returns the new thread handle for use in subsequent definitions.

ucNewThread([ParentThread [, MakeThisDefault]])

Parameter

ParentThread

Optional. If this argument is supplied and the value is not 0, then all definitions from the parent thread are shared with the new thread. If this argument is omitted, then a completely independent thread is defined.

MakeThisDefault

Optional. If this argument is supplied and the value is not 0, then this new thread becomes the default one for subsequent uCalc transactions. For clarity, use the uc_SetDefaultThread constant for this argument, instead of an arbitrary non-zero value.

Remarks

• uCalc allows you to define a group of definitions into a given thread, so that they are completely independent from definitions in other threads. Functions such as ucDefine, ucDefineFunction, ucDefineVariable, etc., all have an optional last argument that accepts a thread handle. For that argument, you can use the handle supplied by ucNewThread. So, you might define function f(), and variable x one way in one thread, and items with the same names a different way in another thread. See Thread Handling for more details.

See this example.

New or enhanced in version 3.0

· If ucNewThread is called with no argument, or 0, then a completely independent thread is started. In the previous version, it would define a thread linked to the default thread, under this circumstance.

· You can set the new thread as the default using the second argument.