5. deallocate

最終更新日時(UTC):
が更新

履歴 編集

function
<memory>

std::allocator::deallocate

void deallocate(pointer p, size_type n);                // C++17 まで
constexpr void deallocate(pointer p, size_type n);      // C++20 から

概要

メモリを解放する。

事前条件

  • C++20まで
    • pは、allocate()によって確保されたポインタ値であること。nは、アロケートされたpのサイズと同じであること
  • C++23以降
    • pがallocate_at_least()によって確保されたポインタ値である場合、allocate_at_least()の戻り値をret、その呼び出しで要求されたサイズをreqとして、
      • pはret.ptrと等しいこと
      • nはreq <= n <= ret.countとなる値であること
    • そうでなければ、pは、allocate()によって確保されたポインタ値であること。nは、アロケートされたpのサイズと同じであること

効果

pが指すストレージを解放する。

例

#include <memory>

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

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

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

出力

参照