std::pmr:: null_memory_resource
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Défini dans l'en-tête
<memory_resource>
|
||
|
std::
pmr
::
memory_resource
*
null_memory_resource
(
)
noexcept
;
|
(depuis C++17) | |
Retourne un pointeur vers un
memory_resource
qui n'effectue aucune allocation.
Valeur de retour
Retourne un pointeur
p
vers un objet de durée de stockage statique d'un type dérivé de
std::pmr::memory_resource
, avec les propriétés suivantes :
-
sa fonction
allocate()lève toujours std::bad_alloc ; -
sa fonction
deallocate()n'a aucun effet ; -
pour toute
memory_resourcer, p - > is_equal ( r ) retourne & r == p .
La même valeur est retournée chaque fois que cette fonction est appelée.
Exemple
Le programme démontre l'utilisation principale de
null_memory_resource
: garantir qu'un pool de mémoire nécessitant une allocation sur la pile n'allouera PAS de mémoire sur le tas s'il a besoin de plus de mémoire.
#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'; }
Sortie possible :
size: 50... size: 100... size: 150... std::bad_alloc size: 183