tis_getspecific

Obtains the data associated with the specified key.

Syntax

tis_getspecific( key);

Argument Data Type Access

key opaque pthread_key_t read

C Binding

#include 


void *
tis_getspecific (
            pthread_key_t   key);

Arguments

key: key identifies a value returned by a call to tis_ key_create. This routine returns the data value associated with the key.

Description

This routine returns the value currently bound to the specified key.

This routine may be called from a data destructor function.

When threads are present, the data and keys are thread-specific; they enable a library to maintain context on a per-thread basis.

Return Values

No errors are returned. This routine returns the data value associated with the given key. If no data value is associated with key, or if key is not defined, then a NULL value is returned.

Associated Routines

   tis_key_create
   tis_key_delete
   tis_setspecific