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

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

Allocates nbytes bytes of storage at specified alignment alignment using the underlying memory resource. Equivalent to return resource()->allocate(nbytes, alignment);.

## Official Specification Summary (cppreference)

```cpp
void* allocate_bytes( std::size_t nbytes,
                      std::size_t alignment = alignof(std::max_align_t) ); // (since C++20)
```

Allocates `nbytes` bytes of storage at specified alignment `alignment` using the underlying memory resource. Equivalent to `return resource()->allocate(nbytes, alignment);`.

### Parameters

- `nbytes` - the number of bytes to allocate
- `alignment` - the alignment to use

### Return value

A pointer to the allocated storage.

### Notes

This function was introduced for use with the fully-specialized allocator `std::pmr::polymorphic_allocator<>`, but it may be useful in any specialization.

The return type is `void*` (rather than, e.g., `std::byte*`) to support conversion to an arbitrary pointer type `U*` by `static_cast<U*>`.

### Exceptions

May throw any exceptions thrown by the call to `resource()->allocate`.

### See also

- [`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/polymorphic_allocator/allocate): allocate memory (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_bytes (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.