CKTIS / C++
new — crear objetos y obtener almacenamiento
Una expresión new crea un objeto y devuelve un puntero a él; normalmente también obtiene almacenamiento. Distínguela de la función de asignación operator new y aprende sobre new[] para arrays y la expresión Placement new, que construye un objeto en el almacenamiento proporcionado.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}Si T no es un tipo array, new T{args...} crea e inicializa un objeto y devuelve un puntero de tipo T*. Una expresión new no es lo mismo que la función operator new: esta última proporciona almacenamiento sin procesar, pero no llama por sí misma a ningún constructor. El inicializador importa: new int deja un valor indeterminado que no debe leerse en C++23; new int{} produce cero.
La forma para arrays new[], como new T[n]{}, crea un array. Si la operación tiene éxito y n > 0, devuelve un puntero al primer elemento. En C++23 se admite n == 0: el array no contiene elementos, por lo que no debes desreferenciar el puntero devuelto. Empareja el new ordinario de un solo objeto con delete, y el new que crea un array con delete[], incluso si el array tiene longitud cero. Por ejemplo, tras using T = int[3];, new T{} devuelve un puntero de tipo int* al primer elemento. Debes usar delete[] para eliminar el array, aunque la expresión new no contenga corchetes. Mezclar estas formas provoca comportamiento indefinido. Eliminar objetos no restablece los punteros que contienen sus direcciones.
La función de asignación estándar que lanza excepciones lanza std::bad_alloc cuando no puede obtener almacenamiento. Si new (std::nothrow) T{} selecciona la sobrecarga estándar de la función de asignación que no lanza excepciones, la expresión devuelve nullptr si falla la asignación. Si T es un tipo de clase, la expresión puede seleccionar en su lugar una sobrecarga de asignación propia de la clase que acepta std::nothrow_t, pero que aun así puede lanzar una excepción. Incluso con la sobrecarga estándar que no lanza excepciones, la expresión puede propagar una excepción del constructor. Comprueba el resultado antes de desreferenciarlo. Si un constructor lanza una excepción, la expresión new llama a una función de desasignación adecuada si encuentra una.
Una expresión Placement new de la forma ::new (address) T{args...}, que usa la sobrecarga estándar que acepta void* de <new>, construye un objeto en almacenamiento existente sin asignarlo. La dirección proporcionada no debe ser nullptr, y el almacenamiento debe ser suficientemente grande, estar correctamente alineado y permanecer disponible durante toda la vida del objeto. Para el búfer del ejemplo, llama a placed->~Item(), no a delete placed; el búfer tiene su propia vida útil.
Ámbito de la entrada: C++23. La opción del compilador asociada en el repositorio no acredita el entorno de ejecución de producción. La URL de la norma proporcionada apunta a un borrador de trabajo en evolución, no a una edición C++23 fija.
Ejemplos
#include <cstddef>
#include <iostream>
#include <new>
struct Item {
int value;
};
int main() {
int* single = new int{7};
std::cout << *single << '\n';
delete single;
int* array = new int[3]{1, 2, 3};
std::cout << array[0] + array[1] + array[2] << '\n';
delete[] array;
alignas(Item) std::byte storage[sizeof(Item)];
Item* placed = ::new (static_cast<void*>(storage)) Item{9};
std::cout << placed->value << '\n';
placed->~Item();
}
Resultado
7 6 9
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.