pthread_equal(3)

pthread_equal3

Compare thread ids

Usage

#include <pthread.h>

int pthread_equal(pthread_t t1, pthread_t t2);

Library

POSIX threads library (libpthread, -lpthread)

Overview

The pthread_equal() function compares two thread identifiers.

Return value

If the two thread IDs are equal, pthread_equal() returns a nonzero value; otherwise, it returns 0.

Errors

This function always succeeds.

Attributes

For an explanation of the terms used in this section, see attributes(7).

InterfaceAttributeValue
pthread_equal()Thread safetyMT-Safe

Notes

The pthread_equal() function is necessary because thread IDs should be considered opaque: there is no portable way for applications to directly compare two pthread_t values.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 10 times.

  1. 3.1
  2. 4.0–5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12
  10. 13
  11. Arch

Standards

POSIX.1-2008.

History

POSIX.1-2001.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.