pthread_setspecific(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

pthread_setspecific(3c)

Standard C Library Functions                           pthread_getspecific(3C)



NAME
       pthread_getspecific, pthread_setspecific - manage thread-specific data

SYNOPSIS
       #include <pthread.h>

       int pthread_setspecific(pthread_key_t key, const void *value);


       void *pthread_getspecific(pthread_key_t key);

DESCRIPTION
       The  pthread_setspecific()  function associates a thread-specific value
       with a key obtained by way of a previous call to  pthread_key_create().
       Different threads may bind different values to the same key. These val‐
       ues are typically pointers to blocks of  dynamically  allocated  memory
       that have been reserved for use by the calling thread.


       The pthread_getspecific() function returns the value currently bound to
       the specified key on behalf of the calling thread.


       The effect of calling  pthread_setspecific()  or  pthread_getspecific()
       with  a  key  value not obtained from pthread_key_create() or after key
       has been deleted with pthread_key_delete() is undefined.


       Both pthread_setspecific() and pthread_getspecific() may be called from
       a   thread-specific   data   destructor   function.   However,  calling
       pthread_setspecific() from a destructor may result in lost  storage  or
       infinite loops.

RETURN VALUES
       The  pthread_getspecific()  function  returns  the thread-specific data
       value associated with the given key. If no thread-specific  data  value
       is associated with key, then the value NULL is returned.


       Upon  successful completion, the pthread_setspecific() function returns
       0. Otherwise, an error number is returned to indicate the error.

ERRORS
       The pthread_setspecific() function will fail if:

       ENOMEM    Insufficient memory exists to associate the  value  with  the
                 key.



       The pthread_setspecific() function may fail if:

       EINVAL    The key value is invalid.



       The pthread_getspecific() function does not return errors.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _  Interface  StabilityCommitted  _  MT-LevelMT-Safe  and
       Async-Signal-Safe _ StandardSee standards(7).


SEE ALSO
       pthread_key_create(3C), attributes(7), standards(7)



Oracle Solaris 11.4               8 Jan 2020           pthread_getspecific(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3