Class RFileWriteStream

RFileWriteStream

Support

Supported from 5.0

Description

Supports the writing of a stream to a file.

Derivation

RFileWriteStream Supports the writing of a stream to a file RWriteStream The write stream interface

Defined in RFileWriteStream:
Attach(), Create(), Open(), RFileWriteStream(), Replace(), Temp()

Inherited from RWriteStream:
Close(), CommitL(), Detach(), Pop(), PushL(), Release(), Sink(), WriteInt16L(), WriteInt32L(), WriteInt8L(), WriteL(), WriteReal32L(), WriteReal64L(), WriteUint16L(), WriteUint32L(), WriteUint8L()

RFileWriteStream()

Description

Constructs an empty write stream object.

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=0 The offset into the file where the stream is to be written. Defaults to zero.

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=0 The offset into the file where the stream is to be written. Defaults to zero.

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 TDesC& 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.

See also:

• TFileMode

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 TDesC& 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.

See also:

• TFileMode

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 TDesC& 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.

See also:

• TFileMode

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 TDesC& aPath The path where the new file is to be created. TFileName& 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.

See also:

• TFileMode