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

CKTIS / C++

Construção direta do objeto resultado a partir de um prvalue

Desde C++17, um prvalue do mesmo tipo de classe constrói o resultado diretamente, sem copiar nem mover o objeto inteiro. A NRVO é opcional e a inicialização dos membros ainda pode copiar dados.

Versão: ISO C++23; implementation support may vary

Sintaxe

T make() { return T{args}; }  // same-type prvalue: constructs the result directly
T value = make();             // initialization, not assignment
T make_named() { T local{args}; return local; }  // optional NRVO

Desde C++17, incluindo em C++23, return T{args}; numa função que devolve T por valor constrói diretamente o objeto resultado. T{args} é um prvalue do mesmo tipo de classe que o resultado, ignorando const e volatile. Não existe um objeto temporário T separado para copiar ou mover. «Elisão de cópia garantida» é o nome habitual desta regra da linguagem, não de uma otimização opcional.

Em T value = make();, value é o objeto resultado da chamada que devolve T por valor. O = desta declaração indica inicialização, não atribuição. Nem mesmo o termo «inicialização por cópia» implica uma chamada ao construtor de cópia. Se T{args} selecionar um construtor de T, esse construtor tem de poder ser utilizado. Se T for um agregado, T{args} pode, em vez disso, fazer a inicialização do agregado sem chamar um construtor de T. O destrutor de T tem de estar acessível no ponto do return e não pode estar eliminado. Não se deve presumir a mesma garantia para um subobjeto de classe base.

return OrderBatch{kOrders}; não copia nem move um OrderBatch inteiro. Isso não impede a cópia de dados de entrada: no exemplo, orders(source) copia a std::string de kOrders para um membro próprio do resultado. O objeto local kOrders é destruído à saída da função, e batch à saída do respetivo bloco em main.

Com return local;, a otimização do valor de retorno nomeado (NRVO) é permitida, mas não obrigatória, se local for um objeto local com nome, não volatile, com duração de armazenamento automática e do mesmo tipo de classe (ignorando os qualificadores cv). Excluem-se os parâmetros de funções e de tratadores de exceções. Com NRVO, o objeto local e o resultado são o mesmo objeto. Em C++23, a resolução de sobrecarga trata esse operando como um xvalue: pode selecionar uma movimentação ou uma cópia. Se não for selecionado um construtor utilizável, o retorno é malformado, mesmo que a NRVO pudesse ser aplicada.

Exemplos

#include <iostream>
#include <string>

struct OrderBatch {
    std::string orders;

    explicit OrderBatch(const std::string& source) : orders(source) {}
    OrderBatch(const OrderBatch&) = delete;
    OrderBatch(OrderBatch&&) = delete;
};

OrderBatch make_batch() {
    const std::string kOrders{"order-42"};
    return OrderBatch{kOrders};
}

int main() {
    OrderBatch batch = make_batch();
    std::cout << batch.orders << '\n';
}

Resultado

order-42

Espera-se que o programa escreva `order-42`. Os construtores de cópia e de movimento de `OrderBatch` estão eliminados; o construtor de cópia de `std::string` não está. Substituir o retorno do prvalue por `OrderBatch local{kOrders}; return local;` deverá produzir um erro de compilação.

Lições relacionadas

  • C++ · Lição 22 · Avançado · Versão: 3

Fontes