pointer allocate( size_type n, std::allocator<void>::const_pointer hint = 0 ); | (1) | (until C++17) |
T* allocate( std::size_t n, const void * hint); | (1) | (since C++17) (deprecated) |
T* allocate( std::size_t n ); | (2) | (since C++17) |
Allocates n * sizeof(T) bytes of uninitialized storage by calling ::operator new(std::size_t), but it is unspecified when and how this function is called. The pointer hint may be used to provide locality of reference: the allocator, if supported by the implementation, will attempt to allocate the new memory block as close as possible to hint.
| n | - | the number of objects to allocate storage for |
| hint | - | pointer to a nearby memory location |
Pointer to the first byte of a memory block suitably aligned and sufficient to hold an array of n objects of type T.
Throws std::bad_alloc if allocation fails.
| [static]
| allocates uninitialized storage using the allocator (public static member function of std::allocator_traits) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/memory/allocator/allocate