tis_setspecific

Sets the data value associated with the specified key.

Syntax

tis_setspecific(
                key,
                value );
 



Argument         Data Type               Access

key              opaque pthread_key_t    read

value            void *                  read

C Binding

#include 


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

Arguments

key: Key that identifies the data to receive value. This key value must be obtained from tis_key_create.
value: New data value to associate with the specified key. Once set, this value can be retrieved using the same key in a call to tis_ getspecific.

Description

This routine sets the data value associated with the specified 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.

Do not call this routine from a data destructor function.

Return Values

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

Return        Description

0             Successful completion.

[EINVAL]      The key value is invalid.

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

Associated Routines

tis_getspecific tis_key_create tis_key_delete