[Overview][Constants][Classes][Index] Reference for unit 'bufstream' (#fcl)

TBufferedFileStream.InitializeCache

Re-initializes the internal buffer for the buffered file stream

Declaration

Source position: bufstream.pp line 138

public procedure TBufferedFileStream.InitializeCache(

  const aCacheBlockSize: Integer;

  const aCacheBlockCount: Integer

);

Arguments

aCacheBlockSize

  

Number of blocks (pages) allocated in the internal buffer

aCacheBlockCount

  

Size for each block (page) allocated in the internal buffer

Description

Re-initializes the internal buffer to use the number of blocks (pages) in aCacheBlockCount where each block (page) has the size in aCacheBlockSize.

InitializeCache checks pages in the internal buffer to see if any have been modified, and writes them to the file stream when needed. Memory allocated to an existing buffer page is freed, and the page is discarded.

Values in aCacheBlockCount and aCacheBlockSize are stored internally, and the buffer size is updated to use the size from the file stream.

InitializeCache re-allocates and zero-fills memory used for each of the pages in the buffer prior to exiting from the method.

InitializeCache is called from the Create method to allocate buffer pages using the default count and size for the class.

Use Flush to write modified values in page buffers to the file stream without re-initializing the internal buffer.

See also

TBufferedFileStream.Flush

  

Flushes modified pages in the buffer to the file stream

TBufferedFileStream.Create

  

Constructor for the class instance


Documentation generated on: May 14 2021