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

개요

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

pthread_setspecific(3c)

pthread_getspecific(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