std::get_temporary_buffer
来自cppreference.com
在标头 <memory> 定义 | ||
template<class T > std::pair<T*, std::ptrdiff_t> | (C++11 前) | |
template<class T > std::pair<T*, std::ptrdiff_t> | (C++11 起) (C++17 弃用) (C++20 移除) | |
如果 count 为负或为零，那么不做任何事。
否则，请求为 count 个相邻的 T 类型对象分配未初始化的相接存储。此请求是非绑定的，并且实现可以改为分配存储其他任意数量（包括零）的相邻对象所需的内存。
是否支持过对齐类型由实现定义。 | (C++11 起) |
目录 |
[编辑]参数
| count | - | 所需的对象数量 |
[编辑]返回值
一个 std::pair，它的 first 成员是指向被分配存储起始的指针，second 成员是适合在实际分配的存储中的对象数。
如果 count <=0 或分配的存储不足以存储单个 T 类型元素，那么结果的 first 成员是空指针且 second 成员为零。
[编辑]注解
此 API 的原本设计目的是提供比通用 operator new 更高效的实现，但无人创建这样的实现，而此 API 被弃用并移除。
[编辑]示例
运行此代码
#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);// 要求将 p.first 传递给 return_temporary_buffer// （当心提前退出和异常），或者更应该使用：std::unique_ptr<std::string, void(*)(std::string*)> on_exit(p.first, [](std::string* p){std::cout<<"返还临时缓冲区...\n";std::return_temporary_buffer(p);}); std::copy(s, s + p.second, std::raw_storage_iterator<std::string*, std::string>(p.first));// 效果等同于：std::uninitialized_copy(s, s + p.second, p.first);// 要求单独销毁每个 p 中的 string// （当心提前退出和异常） 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>();});// 等同于：std::destroy(p.first, p.first + p.second); // 不使用 unique_ptr 这类技巧时要手动回收内存：// std::return_temporary_buffer(p.first);}
输出：
string 1 test ... 返还临时缓冲区...
[编辑]缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 425 | C++98 | count <=0 时的行为不明确 | 使之明确 |
| LWG 2072 | C++98 | 不允许分配不够充足的内存 | 允许 |
[编辑]参阅
(C++17 弃用)(C++20 移除) | 释放未初始化存储 (函数模板) |
[静态](C++23) | 经由分配器分配至少与请求的大小一样大的存储 ( std::allocator_traits<Alloc> 的公开静态成员函数) |
