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
- No-value state indicator [optional.nullopt]
- Changes between C++14 and C++17 (P0636R0)
- Constructors [optional.ctor]
- Assignment [optional.assign]
- Comparison with nullopt [optional.nullops]
- Observers [optional.observe]
- Modifiers [optional.mod]
- numeric_limits members [numeric.limits.members]
- Preamble [expr.pre]
- Logical AND operator [expr.log.and]
- Enum class perms [fs.enum.perms]