Content-type: text/html Man page of pthread_key_delete

pthread_key_delete

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

NAME

pthread_key_delete - Deletes a thread-specific data key.  

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)  

SYNOPSIS

#include <pthread.h>

int pthread_key_delete(
                       pthread_key_t   key);  

STANDARDS

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

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

PARAMETERS

Context key to be deleted.  

DESCRIPTION

This routine deletes the thread-specific data key specified by the key argument, which must have been previously returned by pthread_key_create(3).

The thread-specific data values associated with key need not be NULL at the time this routine is called. The application must 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 this routine is called.

Do not attempt to use the key after calling this routine; this results in unpredictable behavior.

No destructor functions are invoked by this routine. Any destructor functions that may have been associated with key shall no longer be called upon thread exit. pthread_key_delete(3) can be called from within destructor functions.

 

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 key value is an invalid argument.  

ERRORS

None  

RELATED INFORMATION

Functions: pthread_exit(3), pthread_getspecific(3), pthread_key_create(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:41:59 GMT, October 02, 2010