pthread_cleanup_pop()

remove cleanup handler from top of stack and optionally execute it 

Function


SYNOPSIS

#include <pthread.h>

void pthread_cleanup_pop(int execute);


DESCRIPTION

The pthread_cleanup_pop() function removes the cleanup handler routine at the top of the cancellation cleanup stack of the calling thread. If execute is non-zero, the handler function is executed.

pthread_cleanup_push() and pthread_cleanup_pop() must be paired within the same lexical scope (that is, within a bracketed ({}) statement list). The code does not compile otherwise.

Refer to pthread_cancel() for a more detailed discussion of thread cancellation.


PARAMETERS

execute 

Is either zero, or identifies the handler function that is being popped from the stack is executed.


RETURN VALUES

None.


CONFORMANCE

POSIX P1003.1 (1996)


MULTITHREAD SAFETY LEVEL

MT-safe.


PORTING ISSUES

None.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
pthread_cancel(), pthread_cleanup_push()


PTC MKS Toolkit 10.3 Documentation Build 39.