std::allocator::allocate

 

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

 

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

 

std::allocator

Funciones miembro

allocator::allocator

allocator::~allocator

allocator::address (hasta C++20)

allocator::allocate

allocator::allocate_at_least (C++23)

allocator::deallocate

allocator::max_size (hasta C++20)

allocator::construct (hasta C++20)

allocator::destroy (hasta C++20)

Funciones no miembro

operator==operator!= (hasta C++20)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

	(1)
pointer allocate( size_type n, const void * hint = 0 );			(hasta C++17)
T* allocate( std::size_t n, const void * hint);			(desde C++17) (en desuso) (eliminado en C++20)
		(2)
T* allocate( std::size_t n );				(desde C++17) (hasta C++20)
[[nodiscard]] constexpr T* allocate( std::size_t n );				(desde C++20)

See More

Asigna n * sizeof(T) bytes de almacenamiento no inicializado llamando a ::operator new(std::size_t) u ::operator new(std::size_t, std::align_val_t) (desde C++17), pero no se especifica cuándo y cómo se llama a esta función. El puntero hint se puede usar para proporcionar la localidad de referencia: el asignador, si es compatible con la implementación, intentará asignar el nuevo bloque de memoria lo más cerca posible de hint.

Luego, esta función crea un array de tipo T[n] en el almacenamiento y comienza su tiempo de vida, pero no inicia el tiempo de vida de ninguno de sus elementos.

El uso de esta función está mal formado si T es un tipo incompleto.

Para usar esta función en una expresión constante, el almacenamiento asignado debe desasignarse dentro de la evaluación de la misma expresión.

(desde C++20)

Parámetros

n	-	El número de objetos para los que asignar almacenamiento.
hint	-	Puntero a una ubicación de memoria cercana.

Valor de retorno

Puntero al primer elemento de un array de n objetos de tipo T cuyos elementos aún no se han construido.

Excepciones

Lanza std::bad_array_new_length si std::numeric_limits<std::size_t>::max() / sizeof(T) < n.

(desde C++11)

Lanza std::bad_alloc si la asignación de memoria no tiene éxito.

Notas

La redacción "no se especifica cuándo y cómo" hace posible combinar u optimizar asignaciones en el montículo de memoria hechas por los contenedores de la biblioteca estándar, aunque tales optimizaciones no están permitidas para llamadas directas a ::operator new. Por ejemplo, esto se implementa por libc++ ([1] y [2]).

Después de llamar a allocate y antes de la construcción de elementos, la aritmética de punteros de T* está bien definida dentro del array asignado, pero el comportamiento no está definido si se accede a los elementos.

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 3190	C++11	allocate podría asignar almacenamiento del tamaño equivocado.	En su lugar lanza bad_array_new_length.

Véase también

allocate [estático]

asigna almacenamiento sin inicializar utilizando el asignador Original: allocates uninitialized storage using the allocator The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (función miembro estática pública de std::allocator_traits)