Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext

Class template new_allocator

boost::container::new_allocator — This class is a reduced STL-compatible allocator that allocates memory using operator new.

Synopsis

// In header: <boost/container/new_allocator.hpp>

template<typename T> 
class new_allocator {
public:
  // types
  typedef T                      ;                            
  typedef T *                    ;                               
  typedef const T *              ;                         
  typedef T &                    ;                             
  typedef const T &              ;                       
  typedef             ;                             
  typedef          ;                       
  typedef implementation_defined ;  // A integral constant of type bool with value true. 
  typedef implementation_defined ;                         // A integral constant of type bool with value true. 

  // member classes/structs/unions
  template<typename T2> 
  struct rebind {
    // types
    typedef new_allocator< T2 > ;
  };

  // construct/copy/destruct
  () ;
  (const new_allocator &) ;
  template<typename T2> (const new_allocator< T2 > &) ;
  new_allocator & (const new_allocator &) ;

  // public member functions
  pointer ();
  void (pointer, ) ;
   () ;

  // friend functions
  void (new_allocator &, new_allocator &) ;
  bool (const new_allocator &, const new_allocator &) ;
  bool (const new_allocator &, const new_allocator &) ;
};

Description

new_allocator public construct/copy/destruct

  1. () ;

    Default constructor Never throws

  2. (const new_allocator &) ;

    Constructor from other new_allocator. Never throws

  3. template<typename T2> (const new_allocator< T2 > &) ;

    Constructor from related new_allocator. Never throws

  4. new_allocator & (const new_allocator &) ;

    Copy assignment operator from other new_allocator. Never throws

new_allocator public member functions

  1. pointer ( count);

    Allocates memory for an array of count elements. Throws bad_alloc if there is no enough memory

  2. void (pointer ptr,  n) ;

    Deallocates previously allocated memory. Never throws

  3.  () ;

    Returns the maximum number of elements that could be allocated. Never throws

new_allocator friend functions

  1. void (new_allocator &, new_allocator &) ;

    Swaps two allocators, does nothing because this new_allocator is stateless

  2. bool (const new_allocator &, const new_allocator &) ;

    An new_allocator always compares to true, as memory allocated with one instance can be deallocated by another instance

  3. bool (const new_allocator &, const new_allocator &) ;

    An new_allocator always compares to false, as memory allocated with one instance can be deallocated by another instance

Specializations


PrevUpHomeNext