# std::pmr::polymorphic_allocator<T>::allocate

> C++ Atlas: `cppatlas.com/w/cpp/memory/polymorphic_allocator/allocate` | Source: https://en.cppreference.com/w/cpp/memory/polymorphic_allocator/allocate | Domain: Memory management | Standards: C++17, C++20

Allocates storage for n objects of type T using the underlying memory resource. Equivalent to return static_cast<T*>(resource()->allocate(n * sizeof(T), alignof(T)));.

## Official Specification Summary (cppreference)

```cpp
T* allocate( std::size_t n ); // (since C++17)
```

Allocates storage for `n` objects of type `T` using the underlying memory resource. Equivalent to `return static_cast<T*>(resource()->allocate(n * sizeof(T), alignof(T)));`.

### Parameters

- `n` - the number of objects to allocate storage for

### Return value

A pointer to the allocated storage.

### Exceptions

Throws `std::bad_array_new_length` if `n > std::numeric_limits<std::size_t>::max() / sizeof(T)`; may also throw any exceptions thrown by the call to `resource()->allocate`.

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| LWG 3038 | C++17 | `allocate` might allocate storage of wrong size | throws `length_error` instead |
| LWG 3237 | C++17 | the exception thrown by `allocate` was inconsistent with `std::allocator::allocate` | made consistent |

### See also

- [`allocate_bytes`](https://en.cppreference.com/w/cpp/memory/polymorphic_allocator/allocate_bytes) (C++20): allocate raw aligned memory from the underlying resource (public member function)
- [`allocate_object`](https://en.cppreference.com/w/cpp/memory/polymorphic_allocator/allocate_object) (C++20): allocates raw memory suitable for an object or an array (public member function)
- [`new_object`](https://en.cppreference.com/w/cpp/memory/polymorphic_allocator/new_object) (C++20): allocates and constructs an object (public member function)
- [`allocate`](https://en.cppreference.com/w/cpp/memory/allocator_traits/allocate) [static]: allocates uninitialized storage using the allocator (public static member function of `std::allocator_traits<Alloc>`)
- [`allocate`](https://en.cppreference.com/w/cpp/memory/memory_resource/allocate): allocates memory (public member function of `std::pmr::memory_resource`)

---
Attribution: content from https://en.cppreference.com/w/cpp/memory/polymorphic_allocator/allocate (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.