NCollection_StdAllocator< T > Class Template Reference

Implements allocator requirements as defined in ISO C++ Standard 2003, section 20.1.5. More...

#include <NCollection_StdAllocator.hxx>

Data Structures
struct	rebind

Public Types
typedef T	value_type
typedef value_type *	pointer
typedef const value_type *	const_pointer
typedef value_type &	reference
typedef const value_type &	const_reference
typedef size_t	size_type
typedef ptrdiff_t	difference_type

Public Member Functions
	NCollection_StdAllocator () throw ()
	Constructor. More...
	NCollection_StdAllocator (const Handle< NCollection_BaseAllocator > &theAlloc) throw ()
	Constructor. More...
template<typename U >
	NCollection_StdAllocator (const NCollection_StdAllocator< U > &Y) throw ()
	Copy constructor. More...
template<typename U >
NCollection_StdAllocator &	operator= (const NCollection_StdAllocator< U > &Y) throw ()
	Assignment operator. More...
pointer	address (reference x) const
	Returns an object address. More...
const_pointer	address (const_reference x) const
	Returns an object address. More...
pointer	allocate (size_type n, const void *=0)
	Allocates memory for n objects. More...
void	deallocate (pointer p, size_type)
	Frees previously allocated memory. More...
size_type	max_size () const throw ()
	Returns the largest value for which method allocate might succeed. More...
void	construct (pointer p, const_reference val)
	Constructs an object. More...
void	destroy (pointer p)
	Destroys the object. More...
const Handle< NCollection_BaseAllocator > &	Allocator () const
	Returns an underlying NCollection_BaseAllocator instance. More...

Protected Attributes
Handle< NCollection_BaseAllocator >	myAlloc

Detailed Description

template<typename T>
class NCollection_StdAllocator< T >

Implements allocator requirements as defined in ISO C++ Standard 2003, section 20.1.5.

The allocator uses instance of the NCollection_BaseAllocator (sub)class for memory allocation/deallocation. The allocator can be used with standard containers (std::vector, std::map, etc) to take advantage of NCollection_IncAllocator which implements memory region concept, and hence to increase performance in specific cases.

The underlying NCollection_BaseAllocator instance can be received using the Allocator() method.

Example of use:

Handle(NCollection_IncAllocator) anIncAlloc = new NCollection_IncAllocator();
NCollection_StdAllocator<TopoDS_Shape> aSAlloc (anIncAlloc);
std::list<TopoDS_Shape, NCollection_StdAllocator<TopoDS_Shape> > aL (aSAlloc);
TopoDS_Solid aSolid = BRepPrimAPI_MakeBox (10., 20., 30.);
aL.push_back (aSolid);

Member Typedef Documentation

template<typename T >

typedef const value_type* NCollection_StdAllocator< T >::const_pointer

template<typename T >

typedef const value_type& NCollection_StdAllocator< T >::const_reference

template<typename T >

typedef ptrdiff_t NCollection_StdAllocator< T >::difference_type

template<typename T >

typedef value_type* NCollection_StdAllocator< T >::pointer

template<typename T >

typedef value_type& NCollection_StdAllocator< T >::reference

template<typename T >

typedef size_t NCollection_StdAllocator< T >::size_type

template<typename T >

typedef T NCollection_StdAllocator< T >::value_type

Constructor & Destructor Documentation

template<typename T >

NCollection_StdAllocator< T >::NCollection_StdAllocator ( ) throw ( )

inline

Constructor.

Creates an object using default Open CASCADE allocation mechanism, i.e. which uses Standard::Allocate() and Standard::Free() underneath.

template<typename T >

NCollection_StdAllocator< T >::NCollection_StdAllocator ( const Handle< NCollection_BaseAllocator > &  theAlloc ) throw ( )

inline

Constructor.

Saves theAlloc as an underlying allocator instance.

template<typename T >

template<typename U >

NCollection_StdAllocator< T >::NCollection_StdAllocator ( const NCollection_StdAllocator< U > &  Y ) throw ( )

inline

Copy constructor.

Copies Allocator() from Y.

Member Function Documentation

template<typename T >

pointer NCollection_StdAllocator< T >::address ( reference  x ) const

inline

Returns an object address.

Returns &x.

template<typename T >

const_pointer NCollection_StdAllocator< T >::address ( const_reference  x ) const

inline

Returns an object address.

Returns &x.

template<typename T >

pointer NCollection_StdAllocator< T >::allocate ( size_type  n, const void *  = 0  )

inline

Allocates memory for n objects.

Uses underlying allocator to allocate memory.

template<typename T >

const Handle< NCollection_BaseAllocator >& NCollection_StdAllocator< T >::Allocator ( ) const

inline

Returns an underlying NCollection_BaseAllocator instance.

Returns an object specified in the constructor.

template<typename T >

void NCollection_StdAllocator< T >::construct ( pointer  p, const_reference  val  )

inline

Constructs an object.

Uses placement new operator and copy constructor to construct an object.

template<typename T >

void NCollection_StdAllocator< T >::deallocate ( pointer  p, size_type    )

inline

Frees previously allocated memory.

Uses underlying allocator to deallocate memory.

template<typename T >

void NCollection_StdAllocator< T >::destroy ( pointer  p )

inline

Destroys the object.

Uses object destructor.

template<typename T >

size_type NCollection_StdAllocator< T >::max_size ( ) const throw ( )

inline

Returns the largest value for which method allocate might succeed.

template<typename T >

template<typename U >

NCollection_StdAllocator& NCollection_StdAllocator< T >::operator= ( const NCollection_StdAllocator< U > &  Y ) throw ( )

inline

Assignment operator.

Field Documentation

template<typename T >

Handle< NCollection_BaseAllocator > NCollection_StdAllocator< T >::myAlloc

protected

---

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

• NCollection_StdAllocator.hxx