Homepage
Demos
Overview
Downloads
Dev. Resources
Reference
Credits

SharedObject< MC > Class Template Reference

#include <SharedObject.h>

Inheritance diagram for SharedObject< MC >:

Inheritance graph
[legend]
List of all members.

Detailed Description

template<class MC>
class SharedObject< MC >

This templated class allows convenient creation of any type of class wrapped in a shared memory region.

See also:
MotionManager for an example on how to use this.

Definition at line 47 of file SharedObject.h.

Public Member Functions

virtual ~SharedObject ()
MC * operator-> () const
 smart pointer to the underlying class
MC & operator * () const
 smart pointer to the underlying class
MC & operator[] (int i) const
 smart pointer to the underlying class
templated contructors - allows you to pass constructor arguments on to the object being created
if you really need more than 5 arguments for your class, well, you're one crazy puppy but if you really want to, just make more like shown... (yay templates!)

 SharedObject ()
 Creates the class with the default constructor.
template<class T1>
 SharedObject (const T1 &t1)
 Creates the class, passing its constructor t1.
template<class T1, class T2>
 SharedObject (const T1 &t1, const T2 &t2)
 Creates the class, passing its constructor t1 and t2.
template<class T1, class T2, class T3>
 SharedObject (const T1 &t1, const T2 &t2, const T3 &t3)
 Creates the class, passing its constructor t1, t2, and t3.
template<class T1, class T2, class T3, class T4>
 SharedObject (const T1 &t1, const T2 &t2, const T3 &t3, const T4 &t4)
 Creates the class, passing its constructor t1, t2, t3 and t4.
template<class T1, class T2, class T3, class T4, class T5>
 SharedObject (const T1 &t1, const T2 &t2, const T3 &t3, const T4 &t4, const T5 &t5)
 Creates the class, passing its constructor t1, t2, t3, t4 and t5 - if you need more arguments, just add them.
 SharedObject (RCRegion *r)
 Constructs from a pre-existing region, laying claim to the caller's reference to the region - region's creator is responsible for initialization.

Protected Member Functions

MC * dataCasted () const
 returns a correctly typed pointer to the object's memory
virtual void removeRef ()
 removes a reference from rcr, and if necessary, destructs its data

Static Protected Member Functions

static RCRegion * createRCRegion ()
 creates and returns RCRegion of correct size for current class. Adds a reference (which is removed in the destructor)
static unsigned int calcsize ()
 Calculates the size of the memory region to be used, (on Aperios, rounding up to the nearest page size).


Constructor & Destructor Documentation

template<class MC>
SharedObject< MC >::SharedObject  )  [inline]
 

Creates the class with the default constructor.

Definition at line 53 of file SharedObject.h.

template<class MC>
template<class T1>
SharedObject< MC >::SharedObject const T1 &  t1  )  [inline, explicit]
 

Creates the class, passing its constructor t1.

Definition at line 58 of file SharedObject.h.

template<class MC>
template<class T1, class T2>
SharedObject< MC >::SharedObject const T1 &  t1,
const T2 &  t2
[inline]
 

Creates the class, passing its constructor t1 and t2.

Definition at line 63 of file SharedObject.h.

template<class MC>
template<class T1, class T2, class T3>
SharedObject< MC >::SharedObject const T1 &  t1,
const T2 &  t2,
const T3 &  t3
[inline]
 

Creates the class, passing its constructor t1, t2, and t3.

Definition at line 68 of file SharedObject.h.

template<class MC>
template<class T1, class T2, class T3, class T4>
SharedObject< MC >::SharedObject const T1 &  t1,
const T2 &  t2,
const T3 &  t3,
const T4 &  t4
[inline]
 

Creates the class, passing its constructor t1, t2, t3 and t4.

Definition at line 73 of file SharedObject.h.

template<class MC>
template<class T1, class T2, class T3, class T4, class T5>
SharedObject< MC >::SharedObject const T1 &  t1,
const T2 &  t2,
const T3 &  t3,
const T4 &  t4,
const T5 &  t5
[inline]
 

Creates the class, passing its constructor t1, t2, t3, t4 and t5 - if you need more arguments, just add them.

Definition at line 78 of file SharedObject.h.

template<class MC>
SharedObject< MC >::SharedObject RCRegion *  r  )  [inline, explicit]
 

Constructs from a pre-existing region, laying claim to the caller's reference to the region - region's creator is responsible for initialization.

In other words, this SharedObject doesn't AddReference, but will RemoveReference when the time is right (upon destruction). If you want to maintain an reference of your own to the region, you will need to call AddReference yourself.

Definition at line 88 of file SharedObject.h.

template<class MC>
virtual SharedObject< MC >::~SharedObject  )  [inline, virtual]
 

Definition at line 102 of file SharedObject.h.


Member Function Documentation

template<class MC>
static unsigned int SharedObject< MC >::calcsize  )  [inline, static, protected]
 

Calculates the size of the memory region to be used, (on Aperios, rounding up to the nearest page size).

Not sure this is completely necessary, but may be nice. Of course, this also means even small regions are going to be at least 4K (current page size) If memory gets tight or we get a lot of little regions floating around, this might be worth checking into

PLATFORM_APERIOS

Definition at line 147 of file SharedObject.h.

Referenced by SharedObject< UPennWalkMC >::createRCRegion().

template<class MC>
static RCRegion* SharedObject< MC >::createRCRegion  )  [inline, static, protected]
 

creates and returns RCRegion of correct size for current class. Adds a reference (which is removed in the destructor)

Definition at line 126 of file SharedObject.h.

Referenced by SharedObject< UPennWalkMC >::SharedObject().

template<class MC>
MC* SharedObject< MC >::dataCasted  )  const [inline, protected]
 

returns a correctly typed pointer to the object's memory

Definition at line 109 of file SharedObject.h.

Referenced by SharedObject< UPennWalkMC >::operator *(), SharedObject< UPennWalkMC >::operator->(), SharedObject< UPennWalkMC >::operator[](), and SharedObject< UPennWalkMC >::removeRef().

template<class MC>
MC& SharedObject< MC >::operator *  )  const [inline]
 

smart pointer to the underlying class

Definition at line 105 of file SharedObject.h.

template<class MC>
MC* SharedObject< MC >::operator->  )  const [inline]
 

smart pointer to the underlying class

Definition at line 104 of file SharedObject.h.

template<class MC>
MC& SharedObject< MC >::operator[] int  i  )  const [inline]
 

smart pointer to the underlying class

Definition at line 106 of file SharedObject.h.

template<class MC>
virtual void SharedObject< MC >::removeRef  )  [inline, protected, virtual]
 

removes a reference from rcr, and if necessary, destructs its data

Implements SharedObjectBase.

Definition at line 112 of file SharedObject.h.

Referenced by SharedObject< UPennWalkMC >::~SharedObject().


The documentation for this class was generated from the following file:

Tekkotsu v2.4.1
Generated Tue Aug 16 16:35:08 2005 by Doxygen 1.4.4