TSwizzleCBase Class Reference

#include <s32std.h>

class TSwizzleCBase

Detailed Description

Base class for swizzles.

A swizzle maintains a dual representation for an object:

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 class is not intended for instantiation.

Constructor & Destructor Documentation

TSwizzleCBase ( )

TSwizzleCBase()[protected, inline]

TSwizzleCBase ( const TAny * )

TSwizzleCBase(const TAny *aPtr)[protected, inline]

TSwizzleCBase ( TStreamId )

IMPORT_CTSwizzleCBase(TStreamIdanId)[protected]

TSwizzleCBase ( TStreamRef )

TSwizzleCBase(TStreamRefaRef)[protected, inline]

Member Function Documentation

AsId ( )

IMPORT_C TStreamIdAsId()const

Gets the streamid of the represented object.

This swizzle must currently represent the object as a stream id, otherwise the function raises a STORE-Store 3 panic.

Return Value
The stream id of the represented object

DoExternalizeL ( RWriteStream &, TExternalizer< TAny > )

IMPORT_C voidDoExternalizeL(RWriteStream &aStream,
TExternalizer< TAny >anExter
)const [protected]

InternalizeL ( RReadStream & )

IMPORT_C voidInternalizeL(RReadStream &aStream)

Internalises a stream id from the read stream, constructs a swizzle from this stream id and copies the swizzle to this swizzle.

The presence of this function means that the standard templated operator>>() can be used to internalise objects of this class.

Parameters
aStreamStream from which the stream id should be internalised

IsId ( )

TBool IsId()const [inline]

Tests whether this swizzle currently represents an object as a stream id.

Return Value
True, if this swizzle currently maintains the representation of the object as a stream id; False, otherwise. Note that if the swizzle is uninitialised, the value returned by this function is not defined.

IsPtr ( )

TBool IsPtr()const [inline]

Tests whether this swizzle currently represents an object as a pointer.

Return Value
True, if this swizzle currently maintains the object representation as a pointer; False, otherwise. Note that if the swizzle is uninitialised, the value returned by this function is not defined.

Ptr ( )

const TAny *Ptr()const [protected, inline]

operator!= ( const TSwizzleCBase & )

TBool operator!=(const TSwizzleCBase &aSwizzle)const [inline]

Compares for inequality with another swizzle.

Use this operator to determine whether this swizzle represents a different object to that represented by the specified swizzle.

Both this swizzle and the specified swizzle must maintain the representation of their respective objects as either pointers or stream ids.

If one swizzle maintains the representation of its object as a pointer while the other swizzle maintains the representation of its object as a stream id, the comparison is meaningless and always returns true.

Parameters
aSwizzleA reference to the swizzle to be compared with this swizzle.
Return Value
True, if the represented objects are not the same; False, otherwise

operator!= ( const TAny * )

TBool operator!=(const TAny *aPtr)const [inline]

Compares for inequality with an in-memory object.

Use this operator to determine whether this swizzle represents a different in-memory object to that represented by the specified pointer.

This swizzle must maintain the representation of its object as a pointer. If it maintains the representation of its object as a swizzle, the comparison is meaningless and always returns true.

Parameters
aPtrA pointer to the object to be compared with this swizzle.
Return Value
True, if the represented objects are not the same; False, otherwise

operator== ( const TSwizzleCBase & )

TBool operator==(const TSwizzleCBase &aSwizzle)const [inline]

Compares for equality with another swizzle.

Use this operator to determine whether this swizzle represents the same object as that represented by the specified swizzle.

Both this swizzle and the specified swizzle must maintain the representation of their respective objects as either pointers or stream ids.

If one swizzle maintains the representation of its object as a pointer while the other swizzle maintains the representation of its object as a stream id, the comparison is meaningless and always returns false.

Parameters
aSwizzleA reference to the swizzle to be compared with this swizzle.
Return Value
True, if the represented objects are the same; False, otherwise.

operator== ( const TAny * )

TBool operator==(const TAny *aPtr)const [inline]

Compares for equality with an in-memory object.

Use this operator to determine whether this swizzle represents the same in-memory object as that represented by the specified pointer.

This swizzle must maintain the representation of its object as a pointer. If it maintains the representation of its object as a swizzle, the comparison is meaningless and always returns false.

Parameters
aPtrA pointer to the object to be compared with this swizzle.
Return Value
True, if the represented objects are the same; False, otherwise.