Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

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

Class RFileWriteStream

class RFileWriteStream : public RWriteStream;

Description

Supports the writing of a stream to a file.

Derivation

Members

Defined in RFileWriteStream:

Inherited from RWriteStream:


Construction and destruction


RFileWriteStream()

inline RFileWriteStream();

Description

Constructs an empty write stream object.


RFileWriteStream(const MExternalizer< TStreamRef > &)

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

Description

Parameters

const MExternalizer< TStreamRef > &anExter


RFileWriteStream(RFile &,TInt)

IMPORT_C RFileWriteStream(RFile &aFile, TInt aPos=0);

Description

Constructs the write stream object, associates it with an already opened file, and prepares the stream for writing.

Parameters

RFile &aFile

A reference to the opened file.

TInt aPos

The offset into the file where the stream is to be written. Defaults to zero.

[Top]


Member functions


Open(RFs &,const TDesC &,TUint)

IMPORT_C TInt Open(RFs &aFs, const TDesC &aName, TUint aFileMode);

Description

Opens a file containing a stream and prepares the stream for writing.

The stream will be written to offset zero in the file.

Parameters

RFs &aFs

Handle to a file server session.

const TDesC16 &aName

The full path name of the file.

TUint aFileMode

The mode in which the file is to be accessed. The mode is defined by by the TFileMode type.

Return value

TInt

KErrNone, if successful; otherwise, one of the other system wide error codes.


Create(RFs &,const TDesC &,TUint)

IMPORT_C TInt Create(RFs &aFs, const TDesC &aName, TUint aFileMode);

Description

Creates a new file, associates it with this stream, and prepares the stream for writing.

The stream will be written to offset zero in the file.

Parameters

RFs &aFs

Handle to a file server session.

const TDesC16 &aName

The full path name of the new file. A file with this name must not already exist.

TUint aFileMode

The mode in which the file is to be accessed. The mode is defined by by the TFileMode type.

Return value

TInt

KErrNone, if successful; otherwise, one of the other system wide error codes.


Replace(RFs &,const TDesC &,TUint)

IMPORT_C TInt Replace(RFs &aFs, const TDesC &aName, TUint aFileMode);

Description

Creates a new file, associates the file with this stream, and prepares the stream for writing.

The file replaces any existing file of the same name.

The stream will be written to offset zero in the file.

Parameters

RFs &aFs

Handle to a file server session.

const TDesC16 &aName

The full path name of the file.

TUint aFileMode

The mode in which the file is to be accessed. The mode is defined by by the TFileMode type.

Return value

TInt

KErrNone, if successful; otherwise, one of the other system wide error codes.


Temp(RFs &,const TDesC &,TFileName &,TUint)

IMPORT_C TInt Temp(RFs &aFs, const TDesC &aPath, TFileName &aName, TUint aFileMode);

Description

Creates a temporary file, associates it with this stream, and prepares the stream for writing.

The new file is created in the specified path and a unique file name is generated by the file server.

Note that the store framework does not delete a temporary file after it is closed.

The stream will be written to offset zero in the file.

Parameters

RFs &aFs

Handle to a file server session.

const TDesC16 &aPath

The path where the new file is to be created.

TBuf &aName

On return, contains the full path name of the new file.

TUint aFileMode

The mode in which the file is to be accessed. The mode is defined by by the TFileMode type.

Return value

TInt

KErrNone, if successful; otherwise, one of the other system wide error codes.


Attach(RFile &,TInt)

IMPORT_C void Attach(RFile &aFile, TInt aPos=0);

Description

Associates this stream with an already opened file and prepares the stream for writing.

Parameters

RFile &aFile

A reference to the opened file.

TInt aPos

The offset into the file where the stream is to be written. Defaults to zero.