pthread_cleanup_pop() -- remove cleanup handler from top of stack and optionally execute it

SYNOPSIS

#include <pthread.h>

void pthread_cleanup_pop(int execute);

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

pthread_cleanup_pop()
remove cleanup handler from top of stack and optionally execute it

Function