Class: TMonitorEntry

Declaration: Synchronization.h

Taxonomy Categories:

Member Functions:


Interface Category:

API.

Inherits From:

None.

Inherited By:

None.

Purpose:

A concrete class used to implement the monitor and conditions programming model.

Instantiation:

Always allocate on the stack.

Deriving Classes:

This class is not intended to be derived.

Concurrency:

Multithread safe.

Resource Use:

No special requirements.

Member Function: TMonitorEntry::TMonitorEntry

TMonitorEntry (TMonitorLock * theLock)

Interface Category:

API.

Purpose:

Enters a monitor.

Calling Context:

TMonitorEntry is allocated on the stack on entry to a scoping unit that comprises a monitor function.

Parameters:

Return Value:

None.

Exceptions:

Throws TMonitorException(TMonitorException::kInvalidMonitor) if theLock is NIL. Throws TMonitorException(TMonitorException::kLockFailed) if an error occurred while trying to enter the monitor.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TMonitorEntry::~TMonitorEntry

virtual ~ TMonitorEntry ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Return Value:

None.

Exceptions:

Throws TMonitorException(TMonitorException::kUnlockFailed) if an error occurred while trying to exit the monitor.

Concurrency:

Multithread safe.

Other Considerations:

Note that because a TMonitorEntry instance can only be allocated on the stack, TMonitorEntry::~TMonitorEntry is automatically called on exit of the scoping unit in which the instance is created.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.