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

CKTIS / C++

std::unique_ptr — propriedade exclusiva de um recurso

std::unique_ptr é um ponteiro inteligente com propriedade exclusiva que liberta automaticamente o seu recurso. Não pode ser copiado, mas a propriedade pode ser transferida para outro ponteiro.

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

Sintaxe

#include <memory>
std::unique_ptr<T> p = std::make_unique<T>(args...);
std::unique_ptr<T, Deleter> custom;
std::unique_ptr<T[]> array = std::make_unique<T[]>(count);

std::unique_ptr<T, D> de <memory> armazena um ponteiro e um deleter. Quando o proprietário é destruído, chama o deleter para um ponteiro não nulo; esta é uma aplicação de RAII. O deleter predefinido utiliza delete para um único objeto. O parâmetro D permite personalizar a libertação do recurso.

Utilize std::make_unique<T>(args...) para criar um objeto. A cópia de um std::unique_ptr é proibida. A inicialização com auto q = std::move(p); transfere a propriedade para q e deixa p vazio. std::move(p), por si só, não transfere o recurso: permite selecionar uma operação de movimento. Antes de desreferenciar um ponteiro potencialmente vazio, verifique-o com if (p).

get() expõe o ponteiro sem ceder a propriedade. reset() liberta o recurso anterior e deixa o proprietário vazio; reset(ptr) aceita um ponteiro substituto. release() devolve o ponteiro sem libertar o recurso, pelo que o código que o chama tem de assegurar a sua libertação posterior. Não crie dois proprietários independentes do mesmo ponteiro bruto nem elimine manualmente o resultado de get().

Para arrays, utilize std::unique_ptr<T[]>: por predefinição, chama delete[] e disponibiliza operator[] em vez de operator* e operator->. std::make_unique<T[]>(count) cria um array deste tipo. Esta entrada diz respeito a C++23; o site fornecido publica um rascunho em evolução, não um texto C++23 fixo. A opção do compilador do repositório não atesta o ambiente de execução de produção.

Exemplos

#include <iostream>
#include <memory>
#include <utility>

int main() {
    auto p = std::make_unique<int>(42);
    auto q = std::move(p);

    std::cout << std::boolalpha;
    std::cout << "p owns: " << static_cast<bool>(p) << '\n';
    std::cout << "value: " << *q << '\n';

    q.reset();
    std::cout << "q owns: " << static_cast<bool>(q) << '\n';
}

Resultado

p owns: false
value: 42
q owns: false

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