HP-UX Reference (11i v1 05/09) - 3 Library Functions N-Z (vol 7)

pthread_testcancel(3T) pthread_testcancel(3T)

(Pthread Library)

NAME

pthread_testcancel() - process any pending cancellation requests.

SYNOPSIS

#include <pthread.h>

void pthread_testcancel(void);

PARAMETERS

None.

DESCRIPTION

The pthread_testcancel()

function checks for any pending cancellation requests against the calling

thread. If a cancellation request is pending and the calling thread has its cancelability state enabled, the

cancellation request will be acted upon. If the cancelability state of the calling thread is disabled, this func-

tion will have no effect.

RETURN VALUE

None. The

pthread_testcancel()

function does not return a value.

If the calling thread acts upon a cancellation request, this function will not return; the calling thread will be

terminated.

ERRORS

None.

AUTHOR

pthread_testcancel()

was derived from the IEEE POSIX P1003.1c standard.