VMS Help POSIX Threads, PTHREAD routines, pthread_testcancel  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Requests delivery of a pending cancelation request to the calling
    thread.

1 - C Binding

    #include <pthread.h>

    void
    pthread_testcancel (void);

2 - Arguments

    None

3 - Description

    This routine requests delivery of a pending cancelation request
    to the calling thread. Thus, calling this routine creates a
    cancelation point within the calling thread.

    The cancelation request is delivered only if a request is pending
    for the calling thread and the calling thread's cancelability
    state is enabled. (A thread disables delivery of cancelation
    requests to itself by calling pthread_setcancelstate().)

    When called within very long loops, this routine ensures that
    a pending cancelation request is noticed by the calling thread
    within a reasonable amount of time.

4 - Return Values

    None

5 - Associated Routines

       pthread_setcancelstate()