CKTIS / C++
std::nullopt — jawny brak wartości
Użyj `std::nullopt`, aby zwrócić lub ustawić pusty `std::optional` bez mylenia braku wyniku z poprawną wartością, taką jak zero.
Wersja: ISO C++23; implementation support may vary
Składnia
#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 to stała inline constexpr typu std::nullopt_t z nagłówka <optional>, dostępna od C++17. Konstruktor przyjmujący ten znacznik tworzy pusty std::optional<T>, nie konstruując obiektu T. Użyj return std::nullopt;, gdy funkcja zwraca std::optional<T>, a wyniku nie ma. Sama stała nie podaje przyczyny braku.
o == std::nullopt i !o.has_value() sprawdzają brak wartości. if (o) sprawdza obecność, nie zawartość: zapisane 0, false lub nullptr nadal oznacza, że wartość istnieje. Używaj *o i o-> tylko wtedy, gdy wartość istnieje; w C++23 dostęp tymi operatorami do pustego obiektu ma niezdefiniowane zachowanie, natomiast o.value() zgłasza std::bad_optional_access. Zarówno o = std::nullopt, jak i o.reset() niszczą ewentualną wartość; nie używaj później odwołujących się do niej wskaźników ani referencji.
W lekcji 51 std::numeric_limits<int> z <limits> udostępnia granice typu int: max() to największa, a min() najmniejsza reprezentowalna wartość. Dla typów zmiennoprzecinkowych z liczbami subnormalnymi min() oznacza najmniejszą dodatnią wartość znormalizowaną; najniższą wartość skończoną podaje lowest(). Przykład sprawdza granicę odpowiednią dla znaku b, zanim obliczy a + b. Dzięki skróconemu obliczaniu && same odejmowania mieszczą się w zakresie. Suma typu int poza zakresem miałaby niezdefiniowane zachowanie.
W lekcji 48 std::filesystem::perms z <filesystem> to typ wyliczeniowy używany jako maska bitowa uprawnień pliku. Obecna wartość std::filesystem::perms::none oznacza brak ustawionych bitów uprawnień, a pusty std::optional<std::filesystem::perms> oznacza brak wyniku. To tylko kontekst: przykład nie używa tego typu i nie sprawdza ani nie egzekwuje uprawnień.
Przykłady
#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));
}Wynik
0 no result no result
Pierwsze wywołanie wypisuje `0`; dwa kolejne wypisują po jednym `no result`, bo suma wykracza poza zakres `int`.
Powiązane lekcje
- C++ · Lekcja 48 · Zaawansowany · Wersja: 3
- C++ · Lekcja 51 · Zaawansowany · Wersja: 3
Źródła
- 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]