Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

new — criar objetos e obter armazenamento

Uma expressão new cria um objeto e devolve um apontador para ele; normalmente também obtém armazenamento. Distinga-a da função de alocação operator new e conheça new[] para arrays e a expressão Placement new, que constrói um objeto no armazenamento fornecido.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}

Se T não for um tipo array, new T{args...} cria e inicializa um objeto e devolve um apontador do tipo T*. Uma expressão new não é o mesmo que a função operator new: esta fornece armazenamento bruto, mas não chama, por si só, um construtor. O inicializador é importante: new int deixa um valor indeterminado que não deve ser lido em C++23; new int{} produz zero.

A forma new[], como new T[n]{}, cria um array. Se a operação for bem-sucedida e n > 0, devolve um apontador para o primeiro elemento. Em C++23, n == 0 é válido: o array não tem elementos, pelo que não deve desreferenciar o apontador devolvido. Associe delete ao new normal para um único objeto e delete[] ao new que cria um array, mesmo que este tenha comprimento zero. Por exemplo, após using T = int[3];, new T{} devolve um apontador do tipo int* para o primeiro elemento. Tem de usar delete[] para eliminar o array, mesmo que a expressão new não contenha parênteses retos. Misturar estas formas causa comportamento indefinido. Eliminar objetos não repõe os apontadores que guardam os seus endereços.

A função de alocação padrão que lança exceções lança std::bad_alloc quando não consegue obter armazenamento. Se new (std::nothrow) T{} selecionar a sobrecarga padrão da função de alocação que não lança exceções, a expressão devolve nullptr se a alocação falhar. Se T for um tipo de classe, a expressão pode selecionar, em vez disso, uma sobrecarga de alocação específica da classe que aceita std::nothrow_t, mas que pode, ainda assim, lançar uma exceção. Mesmo com a sobrecarga padrão que não lança exceções, a expressão pode propagar uma exceção do construtor. Verifique o resultado antes de o desreferenciar. Se um construtor lançar uma exceção, a expressão new chama uma função de desalocação adequada, caso encontre uma.

Uma expressão Placement new da forma ::new (address) T{args...}, que utiliza a sobrecarga padrão que recebe void* de <new>, constrói um objeto em armazenamento existente sem o alocar. O endereço fornecido não pode ser nullptr, e o armazenamento tem de ser suficientemente grande, estar corretamente alinhado e permanecer disponível durante toda a vida útil do objeto. Para o buffer do exemplo, chame placed->~Item(), não delete placed; o buffer tem uma vida útil própria.

Âmbito da entrada: C++23. A opção do compilador associada no repositório não atesta o ambiente de execução de produção. O URL da norma indicado aponta para um projeto de trabalho em evolução, não para uma edição C++23 fixa.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes