NCollection_IncAllocator Class Reference

#include <NCollection_IncAllocator.hxx>

Inheritance diagram for NCollection_IncAllocator:

Data Structures
struct	IBlock

Public Types
typedef void *	aligned_t

Public Member Functions
	NCollection_IncAllocator (const size_t theBlockSize=DefaultBlockSize)
	Constructor. More...
virtual void *	Allocate (const size_t size)
	Allocate memory with given size. Returns NULL on failure. More...
virtual void	Free (void *anAddress)
	Free a previously allocated memory. Does nothing. More...
size_t	GetMemSize () const
	Diagnostic method, returns the total allocated size. More...
	~NCollection_IncAllocator ()
	Destructor (calls Clean() internally) More...
void *	Reallocate (void *anAddress, const size_t oldSize, const size_t newSize)
	Reallocation: it is always allowed but is only efficient with the last allocated item. More...
void	Reset (const Standard_Boolean doReleaseMem=Standard_True)
	Re-initialize the allocator so that the next Allocate call should start allocating in the very begining as though the allocator is just constructed. Warning: make sure that all previously allocated data are no more used in your code! More...
Public Member Functions inherited from MMgt_TShared
virtual void	Delete () const
	Memory deallocator for transient classes. More...
Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor. More...
	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing. More...
Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter. More...
virtual	~Standard_Transient ()
	Destructor must be virtual. More...
virtual const Handle_Standard_Type &	DynamicType () const
	Returns a type information object about this object. More...
Standard_Boolean	IsInstance (const Handle_Standard_Type &theType) const
	Returns a true value if this is an instance of Type. More...
Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName. More...
Standard_Boolean	IsKind (const Handle_Standard_Type &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
virtual Handle_Standard_Transient	This () const
	Returns a Handle which references this object. Must never be called to objects created in stack. More...
Standard_Integer	GetRefCount () const
	Get the reference counter of this object. More...

Static Public Attributes
static const size_t	DefaultBlockSize = 24600

Protected Member Functions
void	Clean ()
	Flush all previously allocated data. All pointers returned by Allocate() become invalid – be very careful with this. More...
void *	allocateNewBlock (const size_t cSize)
	Allocate a new block and return a pointer to it ** only for internal usage **. More...
Protected Member Functions inherited from NCollection_BaseAllocator
	NCollection_BaseAllocator (void)
	Constructor - prohibited. More...

Protected Attributes
IBlock *	myFirstBlock
size_t	mySize
size_t	myMemSize

Additional Inherited Members
Static Public Member Functions inherited from NCollection_BaseAllocator
static const Handle < NCollection_BaseAllocator > &	CommonBaseAllocator (void)
	CommonBaseAllocator This method is designed to have the only one BaseAllocator (to avoid useless copying of collections). However one can use operator new to create more BaseAllocators, but it is injurious. More...
static void	StandardCallBack (const Standard_Boolean theIsAlloc, const Standard_Address theStorage, const Standard_Size theRoundSize, const Standard_Size theSize)
	Callback function to register alloc/free calls. More...
static void	PrintMemUsageStatistics ()
	Prints memory usage statistics cumulated by StandardCallBack. More...

Detailed Description

Class NCollection_IncAllocator - incremental memory allocator. This class allocates memory on request returning the pointer to an allocated block. This memory is never returned to the system until the allocator is destroyed.

By comparison with the standard new() and malloc() calls, this method is faster and consumes very small additional memory to maintain the heap.

All pointers returned by Allocate() are aligned to the size of the data type "aligned_t". To modify the size of memory blocks requested from the OS, use the parameter of the constructor (measured in bytes); if this parameter is smaller than 25 bytes on 32bit or 49 bytes on 64bit, the block size will be the default 24 kbytes

Member Typedef Documentation

typedef void* NCollection_IncAllocator::aligned_t

Constructor & Destructor Documentation

NCollection_IncAllocator::NCollection_IncAllocator

(

const size_t

theBlockSize = DefaultBlockSize

)

Constructor.

NCollection_IncAllocator::~NCollection_IncAllocator

(

)

Destructor (calls Clean() internally)

Member Function Documentation

virtual void* NCollection_IncAllocator::Allocate ( const size_t  size )

virtual

Allocate memory with given size. Returns NULL on failure.

Reimplemented from NCollection_BaseAllocator.

Reimplemented in NIS_Allocator.

void* NCollection_IncAllocator::allocateNewBlock ( const size_t  cSize )

protected

Allocate a new block and return a pointer to it ** only for internal usage **.

void NCollection_IncAllocator::Clean ( )

protected

Flush all previously allocated data. All pointers returned by Allocate() become invalid – be very careful with this.

virtual void NCollection_IncAllocator::Free ( void *  anAddress )

virtual

Free a previously allocated memory. Does nothing.

Reimplemented from NCollection_BaseAllocator.

Reimplemented in NIS_Allocator.

size_t NCollection_IncAllocator::GetMemSize

(

)

const

Diagnostic method, returns the total allocated size.

void* NCollection_IncAllocator::Reallocate	(	void *	anAddress,
		const size_t	oldSize,
		const size_t	newSize
	)

Reallocation: it is always allowed but is only efficient with the last allocated item.

void NCollection_IncAllocator::Reset

(

const Standard_Boolean

doReleaseMem = Standard_True

)

Re-initialize the allocator so that the next Allocate call should start allocating in the very begining as though the allocator is just constructed. Warning: make sure that all previously allocated data are no more used in your code!

Parameters

doReleaseMem

True - release all previously allocated memory, False - preserve it for future allocations.

Field Documentation

const size_t NCollection_IncAllocator::DefaultBlockSize = 24600

static

IBlock* NCollection_IncAllocator::myFirstBlock

protected

size_t NCollection_IncAllocator::myMemSize

protected

size_t NCollection_IncAllocator::mySize

protected

---

The documentation for this class was generated from the following file:

• NCollection_IncAllocator.hxx