CStreamDictionary Class Reference

#include <s32std.h>

class CStreamDictionary : public CBase

Inherits from

  • CStreamDictionary

    Detailed Description

    Maintains two way associations between a UID (a TUid type) and a stream id (a TStreamId type) .

    Each UID and stream id pair forms an entry in an array. The class provides member functions to manage these entries, for example, to add a new entry or to change the stream id associated with a UID.

    See also: TUid TStreamId CDictionaryStore

    Constructor & Destructor Documentation

    CStreamDictionary ( )

    IMPORT_CCStreamDictionary()

    ~CStreamDictionary ( )

    IMPORT_C~CStreamDictionary()

    Frees resources owned by the object, prior to its destruction.

    Member Function Documentation

    AssignL ( TUid, TStreamId )

    IMPORT_C voidAssignL(TUidaUid,
    TStreamIdanId
    )

    Creates or changes an association between a UID and a stream id.

    If the stream dictionary already contains an entry with the same UID as aUid, then the associated stream id in that entry is replaced by anId.

    If anId has the value KNullStreamId, then the function attempts to remove the entry whose unique identifier matches aUid.

    See also: CStreamDictionary::Remove()

    ParameterDescription
    aUidThe UID
    anIdThe stream id.

    At ( TUid )

    IMPORT_C TStreamIdAt(TUidaUid)const

    Returns the stream id associated with the specified UID.

    ParameterDescription
    aUidThe UID whose associated stream id is to be returned.

    Returns: The stream id associated with the specified UID.KNullStreamId, if no entry in the stream dictionary contains the specified UID.

    ExternalizeL ( RWriteStream & )

    IMPORT_C voidExternalizeL(RWriteStream &aStream)const

    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.

    ParameterDescription
    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 this function has assignment semantics. It replaces the old value of the object with a new value read from the read stream.

    ParameterDescription
    aStreamStream from which the object should be internalised.

    IsNull ( )

    IMPORT_C TBoolIsNull()const

    Tests whether the stream dictionary is empty.

    Returns: True, if the stream dictionary is empty. False if the stream dictionary contains at least one entry.

    NewL ( )

    IMPORT_C CStreamDictionary *NewL()[static]

    Allocates, constructs and returns a pointer to a new stream dictionary.

    The function leaves if it cannot complete successfully.

    Returns: A pointer to the new stream dictionary object.

    NewLC ( )

    IMPORT_C CStreamDictionary *NewLC()[static]

    Allocates, constructs and returns a pointer to a new stream dictionary, putting the pointer onto the cleanup stack.

    Putting the pointer onto the cleanup stack allows the object and allocated resources to be cleaned up if a subsequent leave occurs.

    The function leaves if it cannot complete successfully.

    Returns: A pointer to the new stream dictionary object.

    Remove ( TUid )

    IMPORT_C voidRemove(TUidaUid)

    Removes an association from the stream dictionary.

    The function searches the stream dictionary for an entry whose UID matches aUid. If a match is found, the entry is removed. If no match is found, the stream dictionary remains unchanged.

    ParameterDescription
    aUidThe UID whose matching entry is to be removed from the stream dictionary.