TStreamId Class Reference

#include <s32std.h>

class TStreamId

Detailed Description

Provides unique identification for stream within a store.

A store always assigns a new id and constructs and returns an associated TStreamId object when a new stream is created.

See also: RStoreWriteStream::CreateL() RStoreWriteStream::CreateLC()

Constructor & Destructor Documentation

TStreamId ( )

TStreamId()[inline]

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

TStreamId ( TUint32 )

TStreamId(TUint32aValue)[inline]

Constructs the object with the specified stream ID value.

Users of stores do not normally use this function.

In debug mode, the function checks that the supplied stream ID value is not greater than the maximum permitted value, and raises a STORE-Store 2 panic if it is. In release mode, no checking on the supplied value is done.

The checking of the supplied value is done by a private function implemented in estor. dll. This means that in debug mode, a call is made into estor.dll, but in release mode it is not.

Parameters
aValueThe stream ID value.

Member Function Documentation

ExternalizeL ( RWriteStream & )

voidExternalizeL(RWriteStream &aStream)const [inline]

Externalises an object of this class to a write stream.

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

Parameters
aStreamStream to which the object should be externalised.

InternalizeL ( RReadStream & )

IMPORT_C voidInternalizeL(RReadStream &aStream)

Internalises an object of this class from a read stream.

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

Note that the function has assignment semantics. It replaces the old value of the object with a new value read from the read stream.

Parameters
aStreamStream from which the object should be internalised.

Value ( )

TUint32 Value()const [inline]

Gets the stream ID value encapsulated by this object.

Return Value
The stream ID value.

operator!= ( TStreamId )

TBool operator!=(TStreamIdanId)const [inline]

Inequality comparison operator. Use this operator to determine whether this stream id is unequal to the specified stream id.

Parameters
anIdThe stream id to be compared with this stream id.
Return Value
True, if the two stream ids are unequal, false otherwise.

operator== ( TStreamId )

TBool operator==(TStreamIdanId)const [inline]

Equality comparison operator. Use this operator to determine whether this stream id is equal to the specified stream id.

Parameters
anIdThe stream id to be compared with this stream id.
Return Value
True, if the stream ids are equal; false otherwise