Content-type: text/html Man page of pthread_setspecific

pthread_setspecific

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

pthread_setspecific - Sets the thread-specific data value associated with the specified key for the current thread.  

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)  

SYNOPSIS

#include <pthread.h>

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

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

IEEE Std 1003.1c-1995, POSIX System Application Program Interface  

PARAMETERS

Thread-specific key that identifies the thread-specific data to receive value. This key value must be obtained from pthread_key_create(3)). New thread-specific data value to associate with the specified key for the current thread.  

DESCRIPTION

This routine sets the thread-specific data value associated with the specified key for the current thread. If a value is defined for the key in this thread (the current value is not NULL), the new value is substituted for it. The key is obtained by a previous call to pthread_key_create(3).

Different threads can bind different values to the same key. These values are typically pointers to blocks of dynamically allocated memory that are reserved for use by the calling thread.

Do not call this routine from a thread-specific data destructor function.

Note that although the type for value (void *) implies that it represents an address, the type is being used as a "universal scalar type." DECthreads simply stores value for later retrieval.

 

RETURN VALUES

If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The specified key is invalid. Insufficient memory exists to associate the value with the key.  

ERRORS

None  

RELATED INFORMATION

Functions: pthread_getspecific(3), pthread_key_create(3), pthread_key_delete(3)

Manuals: Guide to DECthreads and Programmer's Guide

delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:39 GMT, October 02, 2010