thrd_create()
QNX SDP8.0C Library ReferenceAPIDeveloper
Create a thread
Synopsis:
#include <threads.h>
typedef int (*thrd_start_t)(void*);
int thrd_create( thrd_t *thr,
thrd_start_t func,
void *arg );
Arguments:
- thr
- NULL, or a pointer to a thrd_t object where the function can store the thread ID of the new thread.
- func
- The routine where the thread begins, with arg as its only
argument.
If func() returns, there's an implicit call to
thrd_exit(),
using the return value of func() as the exit status.
The thread in which main() was invoked behaves differently. When it returns from main(), there's an implicit call to exit(), using the return value of main() as the exit status.
- arg
- The argument to pass to func.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The thrd_create() function creates a new thread. The created thread inherits the signal mask of the parent thread, and its set of pending signals is empty.
Returns:
- thrd_success
- Success.
- thrd_error
- An error occurred.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: