TSwizzle Class Reference

#include <s32std.h>

class TSwizzle : public TSwizzleBase

Inherits from

Detailed Description

Maintains a dual representation for an object. The representation is:

by stream id, if the object is not in memory (the stream contains the external representation of that object).

by pointer, if the object is in memory.

The template class defines the type of object for which the swizzle is a representation. Full access to the represented object is available through the swizzle.

Maintaining a dual representation for an object allows the loading of objects into memory from a store to be deferred; this is particularly important in complex applications.

Constructor & Destructor Documentation

TSwizzle ( )

TSwizzle()[inline]

Constructs an uninitialised swizzle. It is necessary because there are also non-default constructors in this class.

TSwizzle ( T * )

TSwizzle(T *aPtr)[inline]

Constructs a swizzle for a class T type object, represented by a pointer.

Parameters
aPtrA pointer to a class T type object.

TSwizzle ( TStreamId )

TSwizzle(TStreamIdanId)[inline]

Constructs a swizzle for a class T type object, represented as a stream id.

Parameters
anIdThe id of a stream containing the external representation of a class T type object.

Member Function Documentation

AsPtr ( )

T *AsPtr()const [inline]

Returns a pointer to the object which this swizzle represents.

Note that the indirect component selector operator->() can be used to access members of the represented object.

Return Value
A pointer to the class T type object represented by this swizzle.

ExternalizeL ( RWriteStream & )

voidExternalizeL(RWriteStream &aStream)const [inline]

Externalises the stream id of the stream associated with this swizzle.

This function presupposes that:

a store map, i.e. an object of type CStoreMap, has been constructed

the id of the stream containing the external representation of the represented type T object has been bound to this swizzle and added to the store map.

the concrete stream referenced by aStream has been constructed, specifying the store map as an externaliser.

The presence of this function means that the standard templated operator<<() can be used.

See also: CStoreMap

Parameters
aStreamStream to which the stream id should be externalised.

operator T * ( )

operator T *()const [inline]

operator* ( )

T &operator*()const [inline]

Returns a reference to the type T object which this swizzle represents.

Return Value
A reference to the type T object represented by this swizzle.

operator-> ( )

T *operator->()const [inline]

Gives access to members of the type T object which this swizzle represents.

Note, use the AsPtr() member function to return a pointer to the object itself.

Return Value
A pointer to the T type object; not explicitly accessible.

operator= ( T * )

TSwizzle< T > &operator=(T *aPtr)[inline]

Sets this swizzle to represent the in-memory type T object, pointed to by the specified T* pointer.

Parameters
aPtrA pointer to an object of type T which the swizzle is to represent.
Return Value
A reference to this swizzle representing the object of type T.