int
pthread_key_delete(
pthread_key_t key
)
)
function deletes a thread-specific data key previously returned by
pthread_key_create(
).
The thread-specific data values associated with
key
need not be NULL at the time that
pthread_key_delete(
)
is called.
It is the responsibility of the application to free any
application storage or perform any cleanup actions for data structures
related to the deleted key or associated thread-specific data in any threads;
this cleanup can be done either before or after
pthread_key_delete(
)
is called.
Any attempt to use
key
following the call to
pthread_key_delete(
)
results in undefined behavior.
The
pthread_key_delete()
function is callable from within destructor functions.
Destructor functions
are not invoked by
pthread_key_delete(
).
Any destructor function that may have been associated with
key
will no longer be called upon thread exit.
)
function will return zero.
Otherwise an error number will be returned to
indicate the error.
)
may fail if:
EINVAL
]
key
value is invalid.
)
conforms to
ISO/IEC 9945-1:1996 (``POSIX.1'') .
)
and
pthread_key_delete(
)
are flawed and do not permit a clean implementation without
potential problems.
The current implementation of these functions
NetBSD
in addresses these problems by not supporting key reuse.