// C++98
template <class T>
pair<T*, ptrdiff_t> get_temporary_buffer(ptrdiff_t n);

// C++11
template <class T>
pair<T*, ptrdiff_t> get_temporary_buffer(ptrdiff_t n) noexcept;

この機能は、C++17から非推奨となり、C++20で削除された。短期的な用途のメモリ領域確保には、alloca()のようなスタックからメモリを確保するなど、他の機能を使用すること。

概要

短期的なメモリ領域を確保する。

効果

この関数は、強制ではない要素数の指定nに対して、連続する型Tのオブジェクトのための未初期化の領域を確保する。

戻り値

領域へのアドレスをfirst、領域の容量（要素数単位）をsecondとするpairオブジェクトを返す。容量はnより小さいかもしれないし、大きいかもしれない。

n <= 0の場合、または領域が全く確保できなかった場合は、firstをヌルポインタ、secondを0として返す。

例外

• C++11 : 投げない

備考

例えばstable_sort() など、アルゴリズムによっては追加のメモリ領域を利用することで計算量を低減できるものがあり、この関数は主にそういったアルゴリズムの実装内で使用される。

この関数は、短期的なメモリ領域のため、たとえば実装が保持している空き領域リストからサイズの照合を省いて領域を返すなど、実装が最適化されている可能性がある。std::allocator::allocate()を長期的に使用するメモリとして使用することで、この関数との使い分けができるだろう。

ただし、Visual C++ 2013、GCC 4.8 (libstdc++)、Clang 3.4 (libc++)は単にnewを呼んでいるだけで、最適化はとくに行っていない。

非推奨・削除の詳細

std::get_temporary_buffer()関数とstd::return_temporary_buffer()関数は、関数内での一時的なメモリ確保のために、最適化されたメモリ確保の仕組みを提供することを期待して定義されたが、実際にはどの実装も特別なメモリ確保を行わず、そのために使われてこなかった。

将来的にスタックからメモリ確保をする仕組みが検討されているが、これらの関数は設計として例外安全性やRAIIといったものが考慮されていない。スタックからメモリ確保する機能が入ったとしても、これらの関数の内部を改善することはできないと判断され、非推奨となった。

スタックからメモリ確保する機能は、現在の標準ライブラリにはない。そのため、代わりとしては、配置new構文や、標準外のalloca()関数のような機能を使用すること。

例

#include <iostream>
#include <memory>
#include <utility>

int main()
{
  // int型のオブジェクトを3つ構築する想定の領域確保を依頼
  std::pair<int*, std::ptrdiff_t> result = std::get_temporary_buffer<int>(3);

  int* p = result.first;
  std::size_t size = static_cast<std::size_t>(result.second);

  std::allocator<int> alloc;
  using traits = std::allocator_traits<std::allocator<int>>;

  // オブジェクトを構築
  for (std::size_t i = 0; i < size; ++i) {
    traits::construct(alloc, p + i);
  }

  // オブジェクトを破棄
  for (std::size_t i = 0; i < size; ++i) {
    traits::destroy(alloc, p + i);
  }

  // 確保した領域を解放
  std::return_temporary_buffer(p);
}

出力

参照

• Why do I need std::get_temporary_buffer? - Stack Overflow
• LWG2072 Unclear wording about capacity of temporary buffers
• P0174R2 Deprecating Vestigial Library Parts in C++17
• P0619R4 Reviewing deprecated facilities of C++17 for C++20