Panda3D
Public Member Functions

IStreamWrapper Class Reference

This class provides a locking wrapper around an arbitrary istream pointer. More...

Inheritance diagram for IStreamWrapper:
StreamWrapperBase StreamWrapper

List of all members.

Public Member Functions

 IStreamWrapper (istream stream)
 acquire ()
 Acquires the internal lock.
istream getIstream ()
 Returns the istream this object is wrapping.
 release ()
 Releases the internal lock.

Detailed Description

This class provides a locking wrapper around an arbitrary istream pointer.

A thread may use this class to perform an atomic seek/read/gcount operation.


Constructor & Destructor Documentation

IStreamWrapper ( istream  stream)

Member Function Documentation

acquire ( ) [inherited]

Acquires the internal lock.

User code should call this to take temporary possession of the stream and perform direct I/O operations on it, for instance to make several sequential atomic reads. You may not call any of the StreamWrapper methods while the lock is held, other than release().

Use with extreme caution! This is a very low-level, non-recursive lock. You must call acquire() only once, and you must later call release() exactly once. Failing to do so may result in a hard deadlock with no available debugging features.

istream getIstream ( )

Returns the istream this object is wrapping.

release ( ) [inherited]

Releases the internal lock.

Must be called exactly once following a call to acquire(). See the cautions with acquire().

 All Classes Namespaces Functions Variables Enumerations Enumerator Properties