std::pmr::null_memory_resource

From cppreference.com
< cpp‎ | memory
 
 
Utilities library
Type support (basic types, RTTI, type traits)
Dynamic memory management
Error handling
Program utilities
Variadic functions
Date and time
Function objects
(C++11)
Relational operators
Optional and any
(C++17)
(C++17)
Pairs and tuples
(C++11)
(C++17)
Swap, forward and move
(C++14)
(C++11)
(C++11)
Type operations
(C++11)
(C++17)
 
 
Defined in header <memory_resource>
std::pmr::memory_resource* null_memory_resource();
(since C++17)

Returns a pointer to a memory_resource that doesn't perform any allocation.

[edit] Return value

Returns a pointer p to a static storage duration object of a type derived from std::pmr::memory_resource, with the following properties:

  • its allocate() function always throws std::bad_alloc;
  • its deallocate() function has no effect;
  • for any memory_resource r, p->is_equal(r) returns &r == p.

The same value is returned every time this function is called.

[edit] Exceptions

noexcept specification:  
noexcept