TBufferedFileStream class

Declaration

TBufferedFileStream = class(TFileStream)

Inheritance

1. TBufferedFileStream
2. TFileStream
3. THandleStream
4. TStream
5. TObject

Description

TBufferedFileStream is a TFileStream descendant which implements a buffered file stream. It provides a buffer with multiple pages used for random read / write access in the file stream.

By default, It uses a fixed-size buffer consisting of 8 pages with a 4,096 bytes per page. Both page count and page size configurable using the InitializeCache method in the class. The buffer is automatically maintained when the stream size or position is changed, and when reading or writing content to/from the stream.

Pages which have been modified in the buffer are written to the file stream as needed (all pages are used and a read/write operation is performed), when the Flush method is called, and when the class instance is freed. Thus, the class will never use more than the total size obtained by multiplying the CacheBlockSize and aCacheBlockCount arguments to InitializeCache.

This class is suitable when you need to do a lot of random access to a file: hence the use of different pages of configurable size. If you simply wish to speed up sequential reads you better use TReadBufStream or TWriteBufStream for speeding up sequential writes.

See also

• TFileStream
• THandleStream
• TStream
• TReadBufStream
• TWriteBufStream

Methods

Inherited