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

  NAME

      pthread_testcancel - Requests delivery of a pending cancel to the
                           current thread

  SYNOPSIS

      #include <pthread.h>

      void pthread_testcancel();

  DESCRIPTION

  The pthread_testcancel() routine requests delivery of a pending cancel
  to the current thread.  The cancel is delivered only if a cancel is
  pending for the current thread and general cancel delivery is not
  currently disabled. (A thread disables delivery of cancels to itself by
  calling the pthread_setcancel() routine.)

  This routine, when called within very long loops, ensures that a pending
  cancel is noticed within a reasonable amount of time.

  RETURN VALUES

  No value is returned.

  RELATED INFORMATION

      FUNCTIONS:  pthread_cancel
                  pthread_setasynccancel
                  pthread_setcancel