Create a thread with default attributes and the given entry point.

Synopsis

Declared in <bslmt_threadutilimpl_pthread.h>

static
int
create(
    Handle* threadHandle,
    bslmt_ThreadFunction function,
    void* userData);

Description

Create a new thread of program control having platform specific default attributes (i.e., "stack size", "scheduling priority"), that invokes the specified function with a single argument specified by userData, and load into the specified threadHandle, an identifier that may be used to refer to the thread in future calls to this utility. Return 0 on success, and a non‐zero value otherwise. The behavior is undefined if the threadHandle is 0. Note that unless explicitly "detached" (detach), a call to join must be made once the thread terminates to reclaim any system resources associated with the newly created identifier.

Return Value

0 on success, and a non‐zero value otherwise

Parameters

Name

Description

threadHandle

receives an identifier for the new thread

function

entry‐point function invoked by the new thread

userData

sole argument passed to function

Created with MrDocs