NAME

tis_setspecific − Changes the value associated with the specified thread-specific data key. 

LIBRARY

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

SYNOPSIS

#include <tis.h>

int   tis_setspecific(
                         pthread_key_t   key,
                         const void      ∗value);

STANDARDS

None

PARAMETERS

keyThread-specific data Key that identifies the data to receive value.  Must be obtained from a call to tis_key_create(3). 

valueNew value to associate with the specified key.  Once set, this value can be retrieved using the same key in a call to tis_getspecific(3). 

DESCRIPTION

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

Do not call this routine from a data destructor function. 

RETURN VALUES

If an error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are as follows:

0Successful completion. 

[EINVAL]The key value is invalid. 

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

ERRORS

None

RELATED INFORMATION

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

Manuals: Guide to DECthreads and Programmer’s Guide