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
が指すストレージを解放する。
- C++11まで : 解放には
::operator delete(void*)
を使用するが、この関数がいつ呼び出されるかは未規定。 - C++14から : 解放には
::operator delete(void*, std::size_t)
を使用するが、この関数がいつ呼び出されるかは未規定。
例
#include <memory>
int main()
{
std::allocator<int> alloc;
// 10要素のint領域を確保する
std::size_t n = 10;
int* p = alloc.allocate(n);
// 確保したメモリを解放する
alloc.deallocate(p, n);
}
出力