CKTIS / C++
std::nullopt — výslovné vyjádření chybějící hodnoty
Pomocí `std::nullopt` vrať nebo vyprázdni `std::optional`, aniž bys zaměnil chybějící výsledek za platnou hodnotu, například nulu.
Verze: ISO C++23; implementation support may vary
Syntaxe
#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 je konstanta inline constexpr typu std::nullopt_t z hlavičky <optional>, dostupná od C++17. Konstruktor přijímající tuto značku vytvoří prázdný std::optional<T>, aniž by vytvořil objekt typu T. Použij return std::nullopt;, pokud funkce vrací std::optional<T> a nemá žádný výsledek. Konstanta sama neříká, proč výsledek chybí.
o == std::nullopt a !o.has_value() zjišťují, zda hodnota chybí. if (o) testuje přítomnost, nikoli obsah: uložené 0, false nebo nullptr je pořád přítomná hodnota. Operátory *o a o-> používej jen tehdy, když hodnota existuje. V C++23 mají tyto operátory u prázdného objektu nedefinované chování, zatímco o.value() vyvolá výjimku std::bad_optional_access. Jak o = std::nullopt, tak o.reset() zničí případnou uloženou hodnotu. Ukazatele a reference na tuto hodnotu už potom nepoužívej.
V lekci 51 poskytuje std::numeric_limits<int> z <limits> meze typu int: max() vrací největší a min() nejmenší reprezentovatelnou hodnotu. U typů s plovoucí řádovou čárkou se subnormálními hodnotami vrací min() nejmenší kladnou normalizovanou hodnotu; lowest() vrací nejmenší konečnou hodnotu. Příklad ověří mez odpovídající znaménku b před vyhodnocením a + b. Díky zkrácenému vyhodnocování && zůstanou v rozsahu i samotná odčítání. Součet typu int mimo rozsah by měl nedefinované chování.
V lekci 48 je std::filesystem::perms z <filesystem> výčtový typ enum class používaný jako bitová maska oprávnění k souborům. Přítomná hodnota std::filesystem::perms::none znamená, že není nastaven žádný bit oprávnění; prázdný std::optional<std::filesystem::perms> znamená, že výsledek chybí. Jde jen o kontext: příklad tento typ nepoužívá a oprávnění nekontroluje ani nevynucuje.
Příklady
#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));
}Výsledek
0 no result no result
První volání vypíše `0`; další dvě vypíšou každé `no result`, protože součet je mimo rozsah typu `int`.
Související lekce
- C++ · Lekce 48 · Pokročilá · Verze: 3
- C++ · Lekce 51 · Pokročilá · Verze: 3
Zdroje
- 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]