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

CKTIS / C++

std::optional — um valor que pode estar ausente

std::optional<T> representa um objeto do tipo T ou a ausência de um valor. Permite distinguir um resultado em falta de valores válidos, como 0. Verifique se existe um valor antes de utilizar os operadores * e ->.

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

Sintaxe

#include <optional>
std::optional<T> item;
std::optional<T> empty = std::nullopt;
if (item) { /* *item; item->member; */ }

std::optional<T>, declarado em <optional>, armazena um valor do tipo T no seu próprio objeto ou não contém qualquer valor. É útil quando uma função pode não devolver um resultado, mas não precisa de uma descrição do erro. A construção por omissão com std::optional<T> item; produz um estado vazio; a construção a partir de um valor do tipo T produz um estado que contém um valor.

std::nullopt é a constante que indica a ausência de um valor, e std::nullopt_t é o seu tipo marcador distinto, não o tipo do resultado armazenado. Utilize return std::nullopt; para devolver um resultado vazio ou item = std::nullopt; para remover o valor armazenado.

std::optional::operator bool é uma conversão explícita que verifica a presença de um valor; funciona em if (item), de forma semelhante a item.has_value(). Não verifica o próprio valor armazenado: um objeto que contém 0 ou false continua a produzir true.

std::optional::operator* disponibiliza o valor armazenado por referência, enquanto std::optional::operator-> permite aceder aos seus membros. Ambos exigem a presença de um valor. Em C++23, utilizar qualquer um deles num objeto vazio tem comportamento indefinido; não espere uma exceção. O método value() verifica este estado e lança std::bad_optional_access quando não existe qualquer valor.

Esta entrada destina-se a C++23: a opção do compilador utilizada no repositório, sem certificação do ambiente de execução de produção. O projeto de trabalho da norma ligado é atualizado e inclui também extensões posteriores; o seu conteúdo completo não deve ser considerado C++23.

Exemplos

#include <iostream>
#include <optional>

struct Item {
    int count;
};

std::optional<Item> find_item(bool available) {
    if (available) {
        return Item{0};
    }
    return std::nullopt;
}

int main() {
    const auto item = find_item(true);
    if (item) {
        std::cout << item->count << ' ' << (*item).count << '\n';
    }

    const auto missing = find_item(false);
    std::cout << std::boolalpha << missing.has_value() << '\n';
}

Resultado

0 0
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