NAME    [Toc]    [Back]

       tis_getspecific  -  Obtains  the  data associated with the
       specified thread-specific data key

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       void *tis_getspecific(
               pthread_key_t key );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc.so, libc.a)

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       Identifies a value returned  by  a  call  to  tis_key_create(3).  This  routine  returns  the data value associated
       with the thread-specific data key.

DESCRIPTION    [Toc]    [Back]

       This routine returns the  value  currently  bound  to  the
       specified thread-specific data key.

       This  routine  can  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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       Functions:  tis_key_create(3), tis_key_delete(3), tis_setspecific(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                               tis_getspecific(3)