thr_getspecific

Returns the value associated with the specified key.

Library:LibC
Classification:UNIX International
Service:Threads

Syntax

  #include <thread.h> 
   
  int thr_getspecific (
     thread_key_t   key,
     void         **value);
  

Parameters

key

(IN) Specifies the key for which the value is to be returned.

value

(OUT) Points to a location in which to return the value of the specified key. The default initial value associated with each thread for an allocated key is NULL.

Return Values

If successful, returns 0; otherwise, returns a nonzero error code:

Decimal

Constant

Description

9

EINVAL

The specified key is not allocated.

14

ERANGE

The specified key is invalid (out of range).

Remarks

The thr_getspecific function returns the value associated with the specified key for the calling thread.

See Also