/sys$common/syshlp/helplib.hlb DCE_THREADS, Application Routines, pthread_cleanup_pop  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  NAME

      pthread_cleanup_pop - Removes the cleanup handler at the top of the
                            cleanup stack and optionally executes it

  SYNOPSIS

      #include <pthread.h>

      void pthread_cleanup_pop(int execute);

  PARAMETERS

      execute                Integer that specifies whether the cleanup
                             routine that is popped should be executed or
                             just discarded.  If the value is nonzero, the
                             cleanup routine is executed.

  DESCRIPTION

  The pthread_cleanup_pop()  routine removes the routine specified in
  pthread_cleanup_push() from the top of the calling thread's cleanup
  stack and executes it if the value specified in execute is nonzero.

  This routine and pthread_cleanup_push() are implemented as macros and
  must be displayed as statements and in pairs within the same lexical
  scope.  You can think of the pthread_cleanup_push() macro as expanding
  to a string whose first character is a { (left brace) and
  pthread_cleanup_pop as expanding to a string containing the correspond-
  ing } (right brace).

  RETURN VALUES

  This routine must be used as a statement.

  RELATED INFORMATION

      FUNCTIONS: pthread_cleanup_push