Class RWriteStream

class RWriteStream;

Description

The write stream interface. The process of externalising to a stream is achieved through a reference to an object of this type.

A store aware class defines and implements an ExternalizeL(TInt64,RWriteStream &) member function which is used to externalise that object and takes a reference to an RWriteStream as the interface to the write stream.

Members

Defined in RWriteStream:

• Attach(MStreamBuf *)Sets the stream buffer sink for this write stream. The existing sink, if there i...
• Close()Commits data to the stream before freeing resources used by the stream. This ens...
• CommitL()Ensures that any buffered data is written to the stream. Once committed, it is n...
• Detach()Sets the stream buffer sink for this write stream to NULL. The existing sink, if...
• Pop()Removes the cleanup item for this write stream object from the cleanup stack.
• PushL()Puts a cleanup item for this write stream object onto the cleanup stack. This al...
• RWriteStream()The stream buffer sink, as returned by RWriteStream::Sink(), is set to NULL, and...
• RWriteStream(MStreamBuf *)Constructs a write stream over the supplied stream buffer. The stream has no ass...
• RWriteStream(const MExternalizer< TStreamRef > &)Constructs a write stream with an associated store map. The stream buffer sink i...
• Release()Frees resources before abandoning the stream. The function is called after data ...
• Sink()Gets the underlying stream buffer for the write stream. This provides access to ...
• WriteInt16L(TInt)Writes a TInt value as a 16 bit value to this stream.
• WriteInt32L(TInt32)Writes a TInt32 value as a 32 bit value to this stream.
• WriteInt8L(TInt)Writes a TInt value as an 8 bit value to this stream.
• WriteL(RReadStream &)Writes the content of the specified read stream to this write stream.
• WriteL(RReadStream &,TInt)Writes data of the specified length from the specified read stream to this strea...
• WriteL(const TDesC16 &)Writes the content of the 16 bit descriptor to the stream. No other information ...
• WriteL(const TDesC16 &,TInt)Writes data of the specified length from the 16 bit descriptor to the stream. No...
• WriteL(const TDesC8 &)Writes the content of the 8 bit descriptor to the stream. No other information i...
• WriteL(const TDesC8 &,TInt)Writes data of the specified length from the 8 bit descriptor to the stream. No ...
• WriteL(const TUint16 *,TInt)Writes 16 bit data of the specified length from the specified location to this w...
• WriteL(const TUint8 *,TInt)Writes 8 bit data of the specified length from the specified location to this wr...
• WriteReal32L(TReal)Writes a TReal value as a 32 bit value to this stream.
• WriteReal64L(TReal64)Writes a TReal64 value as a 64 bit value to this stream.
• WriteUint16L(TUint)Writes a TUint value as a 16 bit value to this stream.
• WriteUint32L(TUint32)Writes a TUint32 value as a 32 bit value to this stream.
• WriteUint8L(TUint)Writes a TUint value as an 8 bit value to this stream.

inline RWriteStream();

Description

The stream buffer sink, as returned by RWriteStream::Sink(), is set to NULL, and the stream has no associated Store map.

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

Description

Constructs a write stream with an associated store map. The stream buffer sink is set to NULL.

Parameters

inline RWriteStream(MStreamBuf *aSink);

Description

Constructs a write stream over the supplied stream buffer. The stream has no associated Store map.

Parameters

inline MStreamBuf* Sink();

Description

Gets the underlying stream buffer for the write stream. This provides access to the stream-buffer implementation used by the write stream.

Return value

IMPORT_C void Close();

Description

Commits data to the stream before freeing resources used by the stream. This ensures that any buffered data is written to the stream.

Note that the function cannot leave. Any errors arising from the attempt to commit data to the stream are ignored.

IMPORT_C void Release();

Description

Frees resources before abandoning the stream. The function is called after data has been committed to the stream.

Note that if a cleanup item for the stream was placed on the cleanup stack when the stream was opened (e.g by a call to RStoreWriteStreamss CreateLC(), OpenLC(), ReplaceLC() or RDictionaryStores AssignLC() etc), then this function need not be called explicitly; clean up is implicitly done by CleanupStack::PopAndDestroy().

IMPORT_C void CommitL();

Description

Ensures that any buffered data is written to the stream. Once committed, it is not possible to roll back the newly written data.

IMPORT_C void PushL();

Description

Puts a cleanup item for this write stream object onto the cleanup stack. This allows allocated resources to be cleaned up if a subsequent leave occurs.

inline void Pop();

Description

Removes the cleanup item for this write stream object from the cleanup stack.

IMPORT_C void WriteL(const TDesC8 &aDes);

Description

Writes the content of the 8 bit descriptor to the stream. No other information is written to this write stream.

Parameters

IMPORT_C void WriteL(const TDesC8 &aDes, TInt aLength);

Description

Writes data of the specified length from the 8 bit descriptor to the stream. No other information is written to this write stream.

Parameters

IMPORT_C void WriteL(const TUint8 *aPtr, TInt aLength);

Description

Writes 8 bit data of the specified length from the specified location to this write stream.

Parameters

IMPORT_C void WriteL(RReadStream &aStream);

Description

Writes the content of the specified read stream to this write stream.

Parameters

IMPORT_C void WriteL(RReadStream &aStream, TInt aLength);

Description

Writes data of the specified length from the specified read stream to this stream.

Parameters

IMPORT_C void WriteL(const TDesC16 &aDes);

Description

Writes the content of the 16 bit descriptor to the stream. No other information is written to this write stream.

Parameters

IMPORT_C void WriteL(const TDesC16 &aDes, TInt aLength);

Description

Writes data of the specified length from the 16 bit descriptor to the stream. No other information is written to this write stream.

Parameters

IMPORT_C void WriteL(const TUint16 *aPtr, TInt aLength);

Description

Writes 16 bit data of the specified length from the specified location to this write stream.

Parameters

IMPORT_C void WriteInt8L(TInt aValue);

Description

Writes a TInt value as an 8 bit value to this stream.

Parameters

IMPORT_C void WriteInt16L(TInt aValue);

Description

Writes a TInt value as a 16 bit value to this stream.

Parameters

IMPORT_C void WriteInt32L(TInt32 aValue);

Description

Writes a TInt32 value as a 32 bit value to this stream.

Parameters

IMPORT_C void WriteUint8L(TUint aValue);

Description

Writes a TUint value as an 8 bit value to this stream.

Parameters

IMPORT_C void WriteUint16L(TUint aValue);

Description

Writes a TUint value as a 16 bit value to this stream.

Parameters

IMPORT_C void WriteUint32L(TUint32 aValue);

Description

Writes a TUint32 value as a 32 bit value to this stream.

Parameters

IMPORT_C void WriteReal32L(TReal aValue);

Description

Writes a TReal value as a 32 bit value to this stream.

Parameters

IMPORT_C void WriteReal64L(TReal64 aValue);

Description

Writes a TReal64 value as a 64 bit value to this stream.

Parameters

protected: inline void Attach(MStreamBuf *aSink);

Description

Sets the stream buffer sink for this write stream. The existing sink, if there is one, will be discarded.

This is useful for derived classes, enabling them to set the sink following construction.

Note:

RWriteStream::Release() is not called for discarded sinks.

Parameters

protected: inline void Detach();

Description

Sets the stream buffer sink for this write stream to NULL. The existing sink, if there is one, will be discarded.

Note:

RWriteStream::Release() is not called for discarded sinks.