Rudiments
Public Member Functions | List of all members
memorypool Class Reference

Inherits object.

Public Member Functions

 memorypool ()
 
 memorypool (size_t initialsize, size_t incrementsize, size_t resizeinterval)
 
 ~memorypool ()
 
size_t getInitialSize ()
 
size_t getIncrementSize ()
 
size_t getResizeInterval ()
 
byte_t * allocate (size_t size)
 
bool clear ()
 
bool clear (size_t incrementsize, size_t resizeinterval)
 
bool clear (size_t initialsize, size_t incrementsize, size_t resizeinterval)
 
- Public Member Functions inherited from object
virtual ~object ()
 

Detailed Description

The memorypool class provides methods for creating and using a memory pool.

If you have an iterative process that requires variable amounts of memory for each iteration, using a memory pool can perform better than allocating memory on-demand and consume less memory than allocating static buffers that are large enough to accommodate the maximum amount of data you may have to store.

Constructor & Destructor Documentation

◆ memorypool() [1/2]

memorypool::memorypool ( )

Creates a memory pool of initial size 512 bytes.

When the pool needs to grow, it will grow by at least 128 bytes. If more than 128 bytes are requested, it will grow by that amount instead.

When deallocate() has been called 100 times, it will evaluate the average amount of memory allocated (since the last time it did this) and resize the initial buffer size to this size.

◆ memorypool() [2/2]

memorypool::memorypool ( size_t  initialsize,
size_t  incrementsize,
size_t  resizeinterval 
)

Creates a memory pool of initial size "initialsize".

When the pool needs to grow, it will grow by at least "incrementsize" bytes. If more than "incrementsize" bytes are requested, it will grow by that amount instead.

When deallocate() has been called "resizeinterval" times, it will evaluate the average amount of memory allocated (since the last time it did this) and resize the initial buffer size to this size.

◆ ~memorypool()

memorypool::~memorypool ( )

Deletes this instance of the memorypool class.

Member Function Documentation

◆ allocate()

byte_t* memorypool::allocate ( size_t  size)

Returns a pointer to a contiguous block of "size" bytes in the pool. The pool will grow as necessary to accomodate allocations.

◆ clear() [1/3]

bool memorypool::clear ( )

Shrinks the pool back down to it's initial size and frees all previously allocated blocks.

When clear() has been called "resizeinterval" times (see constructor), it evaluates the average amount of memory allocated (since the last time it did this) and resizes the initial buffer size to this size.

Always returns true.

◆ clear() [2/3]

bool memorypool::clear ( size_t  incrementsize,
size_t  resizeinterval 
)

Shrinks the pool back down to it's initial size and frees all previously allocated blocks.

Also resets the increment size and the resize interval to the specified values.

When clear() has been called "resizeinterval" times (see constructor), it evaluates the average amount of memory allocated (since the last time it did this) and resizes the initial buffer size to this size.

Always returns true.

◆ clear() [3/3]

bool memorypool::clear ( size_t  initialsize,
size_t  incrementsize,
size_t  resizeinterval 
)

Shrinks the pool back down to it's initial size and frees all previously allocated blocks.

Also resets the increment size and the resize interval to the specified values, and immediately resets the initial buffer size to initialsize.

Always returns true.

◆ getIncrementSize()

size_t memorypool::getIncrementSize ( )

Returns the size that the pool will grow by when it needs to grow.

◆ getInitialSize()

size_t memorypool::getInitialSize ( )

Returns the initial size of the pool.

◆ getResizeInterval()

size_t memorypool::getResizeInterval ( )

Returns the pool's resize interval.