pthread_cleanup_pop(3)

pthread_cleanup_pop3

Call the first cleanup routine

Usage

#include <pthread.h>

void

pthread_cleanup_pop(int execute);

Overview

The pthread_cleanup_pop() function pops the top cleanup routine off of the current threads cleanup routine stack, and, if execute is non-zero, it will execute the function. If there is no cleanup routine then pthread_cleanup_pop() does nothing.

The pthread_cleanup_pop() function is implemented as a macro that closes a block. Invocations of this function must appear as standalone statements that are paired with an earlier call of pthread_cleanup_push(3) in the same lexical scope.

Return values

The pthread_cleanup_pop() function does not return any value.

Errors

None

Releases

149 releases since Mac OS X 10.2; the text changed 3 times.

  1. 10.2–10.4.11
  2. 10.5–10.5.8
  3. 10.6–10.11.6
  4. 10.12–26.5

Standards

The pthread_cleanup_pop() function conforms to ISO/IEC 9945-1:1996 (“POSIX.1”).

From libpthread 539.100.4 in macOS 26.5. Parsed by carta from the page's mdoc source.