std::pmr::null_memory_resource

From cppreference.com
< cpp‎ | memory
 
C++
 
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)
(C++11)
Relational operators
Optional and any
(C++17)
(C++17)
Pairs and tuples
(C++11)
(C++17)
(C++11)
(C++11)
(C++14)
Swap, forward and move
(C++14)
(C++11)
(C++11)
(C++11)
Type operations
(C++11)
(C++17)
 
Dynamic memory management
Smart pointers
(C++11)
(C++11)
(C++11)
(until C++17)
(C++11)
(C++11)
(C++11)
(C++11)
Allocators
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
Memory resources
(C++17)
(C++17)
(C++17)
(C++17)
pmr::null_memory_resource
(C++17)
(C++17)
(C++17)
(C++17)
(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
  
Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/memory/null_memory_resource&oldid=85636"