命名空间
变体
操作

std::pmr::null_memory_resource

来自 cppreference.com
< cpp‎ | memory
 
 
实用工具库
语言支持
类型支持 (基本类型,RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用工具
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
约束的未初始化内存算法
分配器
垃圾收集支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)



 
定义在头文件 <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_resource rp->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