pthread_equal Subroutine

Purpose

Compares two thread IDs.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>

int pthread_equal (thread1, thread2)
pthread_t thread1;
pthread_t thread2;

Description

The pthread_equal subroutine compares the thread IDs thread1 and thread2. Since the thread IDs are opaque objects, it should not be assumed that they can be compared using the equality operator (==).

Note: The pthread.h header file must be the first included file of each source file using the threads library. Otherwise, the -D_THREAD_SAFE compilation flag should be used, or the cc_r compiler used. In this case, the flag is automatically set.

Parameters

Item Description
thread1 Specifies the first ID to be compared.
thread2 Specifies the second ID to be compared.

Return Values

The pthread_equal function returns a nonzero value if thread1 and thread2 are equal; otherwise, zero is returned.

If either thread1 or thread2 are not valid thread IDs, the behavior is undefined.