PR_NewMonitor
=============
Creates a new monitor object. The caller is responsible for the object
and is expected to destroy it when appropriate.
Syntax
------
.. code::
#include <prmon.h>
PRMonitor* PR_NewMonitor(void);
Returns
~~~~~~~
The function returns one of the following values:
- If successful, a pointer to a :ref:`PRMonitor` object.
- If unsuccessful (for example, if some operating system resource is
unavailable), ``NULL``.
Description
-----------
A newly created monitor has an entry count of zero.
