Welcome to the new DelphiDabbler Code Library Documentation.

This is a new site that's currently running on alpha code. There are going to be bugs. If you discover any, please report them on the site's issues page (GitHub account required). Thanks.

Warning: Many URLs are going to change. Refer to the README file to discover which library project's documentation has been completed.

Flush method

Project: I/O Utility Classes

Unit: PJPipeFilters

Class: TPJPipeFilter

Applies to: ~>1.0

procedure Flush;

Description

Flushes any unprocessed data.

Remarks

Flush is called automatically when the filter object is destroyed.

Actions resulting from calling this method depend on the implementation of descendant classes.

Implementers of new filter classes should note that the required actions must be implemented in the override of the abstract DoFlush method.

Implementations should ensure that multiple calls to Flush between pipe reads have the same effect as calling the method once. For example, assuming that F is an instance of a TPJPipeFilter concrete descendant class, this code:

...
F.ReadPipe;
F.Flush;
F.Flush;
F.ReadPipe;
F.Flush;
F.Free; // calls.F.Flush;
...

should act the same as

...
F.ReadPipe;
F.Flush;
F.ReadPipe;
F.Free;  // calls F.Flush;
...

In some cases this method may legitimately do nothing.