max_unbounded Class

Describes a max class object that does not limit the maximum length of a freelist object.

Syntax

class max_unbounded

Member functions

Member function Description
allocated Increments the count of allocated memory blocks.
deallocated Decrements the count of allocated memory blocks.
full Returns a value that specifies whether more memory blocks should be added to the free list.
released Decrements the count of memory blocks on the free list.
saved Increments the count of memory blocks on the free list.

Requirements

Header: <allocators>

Namespace: stdext

max_unbounded::allocated

Increments the count of allocated memory blocks.

void allocated(std::size_t _Nx = 1);

Parameters

_Nx
The increment value.

Remarks

This member function does nothing. It is called after each successful call by cache_freelist::allocate to operator new. The argument _Nx is the number of memory blocks in the chunk allocated by operator new.

max_unbounded::deallocated

Decrements the count of allocated memory blocks.

void deallocated(std::size_t _Nx = 1);

Parameters

_Nx
The increment value.

Remarks

The member function does nothing. This member function is called after each call by cache_freelist::deallocate to operator delete. The argument _Nx is the number of memory blocks in the chunk deallocated by operator delete.

max_unbounded::full

Returns a value that specifies whether more memory blocks should be added to the free list.

bool full();

Return Value

The member function always returns false.

Remarks

This member function is called by cache_freelist::deallocate. If the call returns true, deallocate puts the memory block on the free list; if it returns false, deallocate calls operator delete to deallocate the block.

max_unbounded::released

Decrements the count of memory blocks on the free list.

void released();

Remarks

This member function does nothing. The released member function of the current max class is called by cache_freelist::allocate whenever it removes a memory block from the free list.

max_unbounded::saved

Increments the count of memory blocks on the free list.

void saved();

Remarks

This member function does nothing. It is called by cache_freelist::deallocate whenever it puts a memory block on the free list.

See also

<allocators>