Reference: IVEThreadGetKeyValue

Overview

Returns the thread-specific value associated with a key. Different threads may have different values associated with the same key.

Prototype (C)

#include "ive_standards.h"
#include "ive_thread.h"
void* IVEThreadGetKeyValue(IVEThreadKey key);

Prototype (Fortran)

There is no Fortran interface.

Parameters

key

key is a handle to thread-local storage initialized with IVEThreadInitKey. The results are not define when IVEThreadGetKeyValue is called with an uninitialized key or a key that has been deleted.

Return value

The value associated with key is returned. Until the thread calls IVEThreadSetKeyValue, the value associated with the key will be zero.

Side effects

Inclusion of ive_standards.h sets certain feature-set macros. It is safest to include it before any other headers to avoid inconsistent definitions.

Cross references

IVEThreadInitKey, IVEThreadDestroyKey, IVEThreadSetKeyValue, and IVEThreadKey

| categories | alphabetical |

modified May 7, 2002