最終更新日時(UTC): 2024年06月11日 13時45分38秒
Akira Takahashi が更新

履歴 編集

function
<memory_resource>

# std::pmr::pool_resource::do_allocate(C++17)

    void* do_allocate(std::size_t bytes, std::size_t alignment) override;

## 概要

要求されたサイズおよびアライメントでメモリを割り当てる。

割り当てられた領域のサイズと配置・要件等は`memory_resource::do_allocate()`に従う。

## 事前条件

`alignment`は2の累乗であること

## 引数

- `bytes` -- 割り当てるメモリのサイズ
- `alignment` -- 割り当てる領域へのアライメント要求

## 効果

`bytes`以上で最小のブロックサイズの内部メモリプールからメモリを割り当てる。
そのようなブロックサイズのプールが枯渇している場合、上流メモリリソースからプールを補充しメモリ割り当てを行う。
プールの補充はチャンク単位で行われ、補充の度にチャンクサイズは増加する。その上限はコンストラクタで渡した`pool_options::max_blocks_per_chunk`か、実装定義の最大値が設定される。

また、`bytes`が設定されている最大のブロックサイズを超える場合は上流メモリリソースから直接メモリを割り当てる。

少なくとも`bytes`のメモリを割り当て、`alignment`にアラインする。

## 戻り値

割り当てた領域の先頭へのポインタ

## 例外

`this->upstream_resource()->allocate()`が例外を投げないのならば、この関数も例外を投げない。

## バージョン

### 言語

- C++17

### 処理系

- Clang: ??
- GCC: 9.1 ✅
- Visual C++: 2017 update 6 ✅

## 関連項目

- `memory_resource`
- `pool_options`

## 参照

- P0220R1 Adopt Library Fundamentals V1 TS Components for C++17 (R1)
- P0337r0 | Delete operator= for polymorphic_allocator
- Working Draft, C++ Extensions for Library Fundamentals, Version 2
- LWG Issue 2843. Unclear behavior of `std::pmr::memory_resource::do_allocate()`