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

CKTIS / C++

std::nullopt — indicar explicitamente a ausência de um valor

Usa `std::nullopt` para devolver ou esvaziar um `std::optional` sem confundir um resultado ausente com um valor válido como zero.

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

Sintaxe

#include <optional>

std::optional<int> no_result() {
    return std::nullopt;
}

void clear(std::optional<int>& result) {
    result = std::nullopt;
}

bool is_empty(const std::optional<int>& result) {
    return result == std::nullopt;
}

std::nullopt é uma constante inline constexpr do tipo std::nullopt_t, definida no cabeçalho <optional> e disponível desde C++17. O construtor que aceita este marcador cria um std::optional<T> vazio sem construir um objeto do tipo T. Usa return std::nullopt; quando uma função devolve std::optional<T> e não tem um resultado. A constante não indica o motivo da ausência.

o == std::nullopt e !o.has_value() testam a ausência de valor. if (o) testa a presença, não o conteúdo: guardar 0, false ou nullptr continua a contar como ter um valor. Usa *o e o-> apenas se existir um valor. Em C++23, estes operadores têm comportamento indefinido num objeto vazio, enquanto o.value() lança std::bad_optional_access. Tanto o = std::nullopt como o.reset() destroem o valor guardado, se existir; não uses posteriormente ponteiros nem referências para esse valor.

Na lição 51, std::numeric_limits<int> de <limits> fornece os limites de int: max() dá o maior valor representável e min() o menor. Para tipos de vírgula flutuante com valores subnormais, min() dá o menor valor positivo normalizado; lowest() dá o menor valor finito. O exemplo verifica o limite que corresponde ao sinal de b antes de avaliar a + b. A avaliação em curto-circuito de && mantém as próprias subtrações dentro do intervalo. Uma soma do tipo int fora do intervalo teria comportamento indefinido.

Na lição 48, std::filesystem::perms de <filesystem> é um tipo de enumeração enum class que funciona como máscara de bits de permissões de ficheiros. Um valor presente std::filesystem::perms::none indica que nenhum bit de permissão está ativo; um std::optional<std::filesystem::perms> vazio indica que não há resultado. É apenas contexto: o exemplo não usa este tipo nem verifica ou faz cumprir permissões.

Exemplos

#include <iostream>
#include <limits>
#include <optional>

std::optional<int> checked_add(int a, int b) {
    using Limits = std::numeric_limits<int>;
    if ((b > 0 && a > Limits::max() - b) ||
        (b < 0 && a < Limits::min() - b)) {
        return std::nullopt;
    }
    return a + b;
}

int main() {
    const auto print = [](std::optional<int> result) {
        if (result) {
            std::cout << *result << '\n';
        } else {
            std::cout << "no result\n";
        }
    };

    print(checked_add(7, -7));
    print(checked_add(std::numeric_limits<int>::max(), 1));
    print(checked_add(std::numeric_limits<int>::min(), -1));
}

Resultado

0
no result
no result

A primeira chamada escreve `0`; as duas seguintes escrevem `no result` cada uma, porque a soma está fora do intervalo de `int`.

Lições relacionadas

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

Fontes