std::set_new_handler

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica(C++20) Servicios del programa Apoyo de corrutinas(C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits(C++20) bitset hash (C++11) Operadores relacionales(en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Gestión de memoria dinámica

Punteros inteligentes unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (hasta C++17) owner_less (C++11) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23) Asignadores de memoria allocator allocator_traits (C++11) allocation_result (C++23) allocate_at_least (C++23) allocator_arg_t (C++11) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20) scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) Recursos de memoria pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17) pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17) Almacenamiento no inicializado raw_storage_iterator (hasta C++20) get_temporary_buffer (hasta C++20) return_temporary_buffer (hasta C++20)

Algoritmos de memoria no inicializada uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) Algoritmos restringidos de memoria no inicializada ranges::uninitialized_copy (C++20) ranges::uninitialized_fill (C++20) ranges::uninitialized_move (C++20) ranges::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::destroy (C++20) ranges::destroy_at (C++20) ranges::uninitialized_copy_n (C++20) ranges::uninitialized_fill_n (C++20) ranges::uninitialized_move_n (C++20) ranges::uninitialized_default_construct_n (C++20) ranges::uninitialized_value_construct_n (C++20) ranges::destroy_n (C++20) ranges::construct_at (C++20) Apoyo para recolección de basura declare_reachable (C++11)(hasta C++23) undeclare_reachable (C++11)(hasta C++23) declare_no_pointers (C++11)(hasta C++23) undeclare_no_pointers (C++11)(hasta C++23) pointer_safety (C++11)(hasta C++23) get_pointer_safety (C++11)(hasta C++23) Misceláneos pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) Biblioteca de C malloc aligned_alloc (C++17) calloc realloc free Gestión de memoria de bajo nivel operator new operator new[] operator delete operator delete[] get_new_handler set_new_handler bad_alloc bad_array_new_length nothrow_t align_val_t destroying_delete_t new_handler nothrow

 

Gestión de memoria de bajo nivel

Funciones

operator newoperator new[]

operator deleteoperator delete[]

get_new_handler (C++11)

set_new_handler

Clases

bad_alloc

bad_array_new_length (C++11)

nothrow_t

align_val_t (C++17)

destroying_delete_t (C++20)

Tipos

new_handler

Objetos

nothrow

 

Definido en el archivo de encabezado <new>
std::new_handler set_new_handler(std::new_handler new_p )throw();		(hasta C++11)
std::new_handler set_new_handler(std::new_handler new_p )noexcept;		(desde C++11)

Hace a new_p la nueva función global del controlador de new y devuelve el controlador de new instalado previamente.

La función del controlador de new es la función que se llama por las funciones de asignación en cualquier ocasión en la que falla un intento de asignar memoria. Su propósito es uno de las tres siguientes:

1) hacer más memoria disponible;

2) terminar el programa (por ejemplo, al llamar a std::terminate);

3) lanzar una excepción de tipo std::bad_alloc o derivada de std::bad_alloc.

La implementación por defecto lanza std::bad_alloc. El usuario puede instalar su propio controlador de new, que puede ofrecer un comportamiento distinto del predeterminado.

Se el controlador de new regresa, la función de asignación repite el intento de asignación previamente fallido y llama al controlador de new nuevamente si la asignación vuelve a fallar. Para terminal el ciclo, el controlador de new puede llamar a std::set_new_handler(nullptr): si, después de un intento de asignación fallido, la función de asignación se da cuenta que std::get_new_handler devuelve un valor de puntero nulo, lanzará std::bad_alloc.

Al inicio del programa, el controlador de new es un puntero nulo.

Esta función es segura contra hilos. Cada llamada a std::set_new_handler se sincroniza-con (véase std::memory_order) las llamadas subsecuentes a std::set_new_handler y std::get_new_handler.

(desde C++11)

Parámetros

new_p

-

Puntero a función de tipo std::new_handler, o un puntero nulo.

Valor de retorno

El controlador de new previamente instalado, o un valor de puntero nulo si no se ha instalado ninguno.

Ejemplo

Ejecuta este código

#include <iostream>#include <new>   void handler(){std::cout<<"Falla al asignar memoria, terminando\n"; std::set_new_handler(nullptr);}   int main(){ std::set_new_handler(handler);try{while(true){ new int[100000000ul];}}catch(conststd::bad_alloc& e){std::cout<< e.what()<<'\n';}}

Salida:

Falla al asignar memoria, terminando std::bad_alloc

Véase también

operator newoperator new[]	Funciones de asignación. (función)
get_new_handler (C++11)	Obtiene el nuevo controlador actual. (función)
new_handler	Tipo de puntero a función del nuevo controlador. (typedef)
bad_alloc	Excepción que se produce cuando la asignación de memoria falla. (clase)