std::set_new_handler

std::new_handler set_new_handler( std::new_handler new_p ) throw();

std::new_handler set_new_handler( std::new_handler new_p ) noexcept;

Définit new_p la nouvelle fonction new-handler globale et retourne le new-handler précédemment installé.

La new-handler est la fonction appelée par les fonctions d'allocation chaque fois qu'une tentative d'allocation mémoire échoue. Son objectif prévu est l'une des trois choses suivantes :

L'implémentation par défaut lance std::bad_alloc. L'utilisateur peut installer son propre new-handler, qui peut offrir un comportement différent de celui par défaut.

Si new-handler retourne, la fonction d'allocation répète la tentative d'allocation précédemment échouée et appelle le new-handler à nouveau si l'allocation échoue encore. Pour terminer la boucle, new-handler peut appeler std::set_new_handler(nullptr): si, après une tentative d'allocation échouée, la fonction d'allocation constate que std::get_new_handler retourne une valeur de pointeur nul, elle lancera std::bad_alloc.

Au démarrage du programme, new-handler est un pointeur nul.

Paramètres

Valeur de retour

Le gestionnaire de nouvelle installation précédent, ou une valeur de pointeur nul si aucun n'était installé.

Exemple

#include <iostream>
#include <new>
void handler()
{
    std::cout << "Memory allocation failed, terminating\n";
    std::set_new_handler(nullptr);
}
int main()
{
    std::set_new_handler(handler);
    try
    {
        while (true)
        {
            new int[1000'000'000ul]();
        }
    }
    catch (const std::bad_alloc& e)
    {
        std::cout << e.what() << '\n';
    }
}

Memory allocation failed, terminating
std::bad_alloc

Voir aussi