allocate.md

allocate

• memory[meta header]
• std[meta namespace]
• allocator[meta class]
• function[meta id-type]

pointer allocate(size_type n);                         // (1) C++03
[[nodiscard]] pointer allocate(size_type n);           // (1) C++20

pointer allocate(size_type n,
                 allocator<void>::const_pointer hint); // (2) C++17から非推奨

概要

メモリを確保する。

戻り値

適切にアライメント配置されたn * sizeof(T)サイズのストレージの配列の、最初の要素へのポインタを返す。
ストレージは、::operator new(std::size_t)の呼び出しによって取得される。

この関数の呼び出し頻度やヒントの扱いは未規定。

例外

ストレージからのメモリ確保に失敗した場合、bad_alloc例外を送出する。

備考

コンテナのメンバ関数でこの関数を使用する場合には、隣接要素のアドレスをヒントとして渡すのが適している。

非推奨の詳細

ヒントパラメータは、アロケータ実装者に使われなかったため、非推奨となった。

例

#include <memory>

int main()
{
  std::allocator<int> alloc;

  // 10要素のint領域を確保する
  std::size_t n = 10;
  int* p = alloc.allocate(n);

  // 確保したメモリを解放する
  alloc.deallocate(p, n);
}

• allocate[color ff0000]
• alloc.deallocate[link deallocate.md]

出力

参照

• P0174R2 Deprecating Vestigial Library Parts in C++17
• P0600R1 [[nodiscard]] in the Library