Ifcount is negative or zero, does nothing.

Otherwise, requests to allocate uninitialized contiguous storage forcount adjacent objects of typeT. The request is non-binding, and the implementation may instead allocate the storage for any other number of (including zero) adjacent objects of typeT.

[edit]Parameters

[edit]Return value

Astd::pair, the memberfirst is a pointer to the beginning of the allocated storage and the membersecond is the number of objects that fit in the storage that was actually allocated.

Ifcount<=0 or allocated storage is not enough to store a single element of typeT, the memberfirst of the result is a null pointer and the membersecond is zero.

[edit]Notes

This API was originally designed with the intent of providing a more efficient implementation than the general-purposeoperator new, but no such implementation was created and the API was deprecated and removed.

[edit]Example

#include <algorithm>#include <iostream>#include <iterator>#include <memory>#include <string> int main(){conststd::string s[]={"string","1","test","..."};constauto p= std::get_temporary_buffer<std::string>(4);// requires that p.first is passed to return_temporary_buffer// (beware of early exit points and exceptions), or better use:std::unique_ptr<std::string,void(*)(std::string*)> on_exit(p.first,[](std::string* p){std::cout<<"returning temporary buffer...\n";std::return_temporary_buffer(p);}); std::copy(s, s+ p.second,std::raw_storage_iterator<std::string*,std::string>(p.first));// has same effect as: std::uninitialized_copy(s, s + p.second, p.first);// requires that each string in p is individually destroyed// (beware of early exit points and exceptions) std::copy(p.first, p.first+ p.second,std::ostream_iterator<std::string>{std::cout,"\n"}); std::for_each(p.first, p.first+ p.second,[](std::string& e){        e.~basic_string<char>();});// same as: std::destroy(p.first, p.first + p.second); // manually reclaim memory if unique_ptr-like technique is not used:// std::return_temporary_buffer(p.first);}

string1test...returning temporary buffer...

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文