Destructor.

Frees all resources owned by the object, prior to its destruction.

Specifically, it frees all segments allocated to the buffer.

Gets a pointer descriptor to represent the data starting at the beginning of the contiguous region containing that byte through to the byte immediately preceding the specified byte.

The descriptor always points to the beginning of the segment containing the specified byte. The time needed for calculation of the pointer depends on how many segments there are in the buffer, and how near the target segment is to the segment which was last used in the buffer.

CBufBase::BackPtr

Compresses the buffer so as to occupy minimal space.

Fills any space in each segment of the buffer by moving contents from the next segment to the current one. Where this activity results in empty segments, it frees the memory associated with these segments.

CBufBase::Compress

Deletes data from the buffer.

During deletion, shuffling is minimised by deleting intermediate segments and allowing segments to contain less data than the buffer granularity.

CBufBase::Delete

Allocates and constructs a segmented buffer.

If there is insufficient memory available to allocate the segmented buffer, the function leaves.

Gets a pointer descriptor to represent the data starting at the specified data byte through to the end of the contiguous region containing that byte.

The time needed for calculation of the pointer depends on how many segments there are in the buffer, and how near the target segment is to the segment which was last used in the buffer.