std::pmr::null_memory_resource
来自 cppreference.cn
| 定义于头文件 <memory_resource> |
||
| std::pmr::memory_resource* null_memory_resource() noexcept; |
(自 C++17 起) | |
返回一个指向 memory_resource 的指针，该指针不执行任何分配。
[编辑] 返回值
返回一个指针 p，指向一个从 std::pmr::memory_resource 派生的静态存储期对象，具有以下属性
- 它的
allocate()函数总是抛出 std::bad_alloc； - 它的
deallocate()函数不起作用； - 对于任何
memory_resourcer，p->is_equal(r) 返回 &r == p。
每次调用此函数时都返回相同的值。
[编辑] 示例
该程序演示了 null_memory_resource 的主要用法：确保需要堆栈上分配内存的内存池，如果需要更多内存，将不会在堆上分配内存。
运行此代码
#include <array> #include <cstddef> #include <iostream> #include <memory_resource> #include <string> #include <unordered_map> int main() { // allocate memory on the stack std::array<std::byte, 20000> buf; // without fallback memory allocation on heap std::pmr::monotonic_buffer_resource pool{buf.data(), buf.size(), std::pmr::null_memory_resource()}; // allocate too much memory std::pmr::unordered_map<long, std::pmr::string> coll{&pool}; try { for (std::size_t i = 0; i < buf.size(); ++i) { coll.emplace(i, "just a string with number " + std::to_string(i)); if (i && i % 50 == 0) std::clog << "size: " << i << "...\n"; } } catch (const std::bad_alloc& e) { std::cerr << e.what() << '\n'; } std::cout << "size: " << coll.size() << '\n'; }
可能的输出
size: 50... size: 100... size: 150... std::bad_alloc size: 183
