Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <S32STD.H>
Link against: estor.lib

Class RStoreWriteStream

class RStoreWriteStream : public RWriteStream;

Description

Supports the writing of a stream to a store.

The class allows:

creation of a new stream

overwriting of an existing stream

replacement of an existing stream

appending to an existing stream

Derivation

Members

Defined in RStoreWriteStream:

Inherited from RWriteStream:


Construction and destruction


RStoreWriteStream()

inline RStoreWriteStream();

Description

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


RStoreWriteStream(const MExternalizer< TStreamRef > &)

inline RStoreWriteStream(const MExternalizer< TStreamRef > &anExter);

Description

Constructs an object with an externaliser. The store map CStoreMap is an example of an externalizer.

Parameters

const MExternalizer< TStreamRef > &anExter

Specifies an externaliser

[Top]


Member functions


CreateL(CStreamStore &)

IMPORT_C TStreamId CreateL(CStreamStore &aStore);

Description

Creates a new stream.

The function creates a new stream in the specified store and prepares the stream for writing. The function returns the new stream id, and leaves if it cannot complete successfully.

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store which is to contain the new stream.

Return value

TStreamId

The stream id of the newly created stream.

See also:


CreateLC(CStreamStore &)

IMPORT_C TStreamId CreateLC(CStreamStore &aStore);

Description

Creates a new stream, putting a cleanup item onto the cleanup stack.

The function creates a new stream in the specified store and prepares the stream for writing. The function returns the new stream id, and leaves if it cannot complete successfully.

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

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store which is to contain the new stream.

Return value

TStreamId

The stream id of the newly created stream.

See also:


OpenL(CStreamStore &,TStreamId)

IMPORT_C void OpenL(CStreamStore &aStore, TStreamId anId);

Description

Opens an existing stream and prepares it for overwriting.

The function leaves if cannot complete successfully.

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store containing the stream.

TStreamId anId

The id of the stream to be overwritten.

See also:


OpenLC(CStreamStore &,TStreamId)

IMPORT_C void OpenLC(CStreamStore &aStore, TStreamId anId);

Description

Opens an existing stream, prepares it for overwriting, and puts a cleanup item onto the cleanup stack.

The function leaves if cannot complete successfully.

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

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store containing the stream.

TStreamId anId

The id of the stream to be overwritten.

See also:


ReplaceL(CStreamStore &,TStreamId)

IMPORT_C void ReplaceL(CStreamStore &aStore, TStreamId anId);

Description

Opens an existing stream and prepares it for replacement.

The function leaves if it cannot complete successfully.

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store containing the stream.

TStreamId anId

The id of the stream to be replaced.

See also:


ReplaceLC(CStreamStore &,TStreamId)

IMPORT_C void ReplaceLC(CStreamStore &aStore, TStreamId anId);

Description

Opens an existing stream, prepares it for replacement and puts a cleanup item onto the cleanup stack.

The function leaves if it cannot complete successfully.

Placing a cleanup item onto the cleanup stack allows allocated resources to be cleaned up if a subsequent leave occurs.

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store containing the stream.

TStreamId anId

The id of the stream to be replaced.

See also:


AppendL(CStreamStore &,TStreamId)

IMPORT_C void AppendL(CStreamStore &aStore, TStreamId anId);

Description

Opens an existing stream and prepares it for appending.

The function leaves if it cannot complete successfully.

Note that a call to this function must be matched by a call to RWriteStream::CommitL() before this object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store containing the stream.

TStreamId anId

The id of the stream to be appended.

See also:


AppendLC(CStreamStore &,TStreamId)

IMPORT_C void AppendLC(CStreamStore &aStore, TStreamId anId);

Description

Opens an existing stream, prepares it for appending, and puts a cleanup item onto the cleanup stack.

The function leaves if it cannot complete successfully.

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

Note that call to this function must be matched by a call to RWriteStream::CommitL() before the RStoreWriteStream object is disposed of.

Parameters

CStreamStore &aStore

A reference to the store containing the stream.

TStreamId anId

The id of the stream to be appended.

See also: