Class RRef

class RRef : public RRefBase;

Description

Contains, or packages, a copy of an instance of another class.

The template parameter defines the type of the contained object.

The contained object is held in allocated memory, and can be accessed through the member selection and dereference operators.

Derivation

• RRefBase - Base class that provides an implementation for the templated RRef class.

• RRef - Contains, or packages, a copy of an instance of another class.

Members

Defined in RRef:

• Alloc(const T &)Creates a copy of the specified object, which is to be contained by this referen...
• Alloc(const T &,TInt)Creates a copy of the specified object, which is to be contained by this referen...
• AllocL(const T &)Creates a copy of the specified object, which is to be contained by this referen...
• AllocL(const T &,TInt)Creates a copy of the specified object, which is to be contained by this referen...
• RRef()Default constructor.
• RRef(const RRef< T > &)Copy constructor.
• operator T *()Gets a pointer to the contained object.
• operator->()Gets a pointer to the contained object.
• operator=(const RRef< T > &)Assignment operator.

Inherited from RRefBase:

• Copy(const RRefBase &)Provides an implementation for the RRef class copy constructor and assignment op...
• DoAlloc(const TAny *,TInt)Creates a copy of an object, which is to be contained by this reference object.
• DoAllocL(const TAny *,TInt)Creates a copy of an object, which is to be contained by this reference object, ...
• Free()Frees the memory holding the contained object.
• RRefBase(const RRefBase &)Copy constructor.
• iPtr

inline RRef();

Description

Default constructor.

inline RRef(const RRef< T > &anObject);

Description

Copy constructor.

The constructor frees any existing contained object, and takes ownership of the object owned by anObject.

Parameters

const RRef< T > &anObject A reference to another 'reference' object. On return from this constructor, anObject may be safely orphaned if it lives on the program stack.

inline void operator=(const RRef< T > &anObject);

Description

Assignment operator.

The constructor frees any existing contained object, and takes ownership of the object owned by anObject.

Parameters

const RRef< T > &anObject A reference to another 'reference' object. On return from this constructor, anObject may be safely orphaned if it lives on the program stack.

inline T* operator->();

Description

Gets a pointer to the contained object.

Return value

T * A pointer to the contained object

inline operator T *();

Description

Gets a pointer to the contained object.

Return value

A pointer to the contained object

inline void Alloc(const T &anObject);

Description

Creates a copy of the specified object, which is to be contained by this reference object.

The amount of memory set aside to contain the object is defined by the size of the object

Parameters

const T &anObject The object to be packaged up by this reference object.

inline void Alloc(const T &anObject, TInt aSize);

Description

Creates a copy of the specified object, which is to be contained by this reference object.

The amount of memory set aside to contain the object is defined by aSize.

Parameters

const T &anObject The object to be packaged up by this reference object. TInt aSize The amount of memory to be set aside to contain the object. You must make sure that this is big enough.

inline void AllocL(const T &anObject);

Description

Creates a copy of the specified object, which is to be contained by this reference object, and leaves on failure.

The amount of memory set aside to contain the object is defined by the size of the object

Parameters

const T &anObject The object to be packaged up by this reference object.

inline void AllocL(const T &anObject, TInt aSize);

Description

Creates a copy of the specified object, which is to be contained by this reference object, and leaves on failure.

The amount of memory set aside to contain the object is defined by aSize.

Parameters

const T &anObject The object to be packaged up by this reference object. TInt aSize The amount of memory to be set aside to contain the object. You must make sure that this is big enough.