CKTIS / C++
std::nullopt — izričita oznaka odsutnosti vrijednosti
Upotrijebi `std::nullopt` za vraćanje ili pražnjenje objekta `std::optional` bez brkanja odsutnog rezultata s valjanom vrijednošću poput nule.
Verzija: ISO C++23; implementation support may vary
Sintaksa
#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 tipa std::nullopt_t iz zaglavlja <optional>, dostupna od C++17. Konstruktor koji prima tu oznaku stvara prazan std::optional<T> bez stvaranja objekta tipa T. Upotrijebi return std::nullopt; kada funkcija vraća std::optional<T> i nema rezultata. Sama konstanta ne govori zašto rezultat nedostaje.
o == std::nullopt i !o.has_value() provjeravaju odsutnost vrijednosti. if (o) provjerava prisutnost, a ne sadržaj: pohranjeni 0, false ili nullptr i dalje je prisutna vrijednost. Upotrebljavaj *o i o-> samo kad je vrijednost prisutna. U C++23 ti operatori imaju nedefinirano ponašanje na praznom objektu, dok o.value() baca iznimku std::bad_optional_access. I o = std::nullopt i o.reset() uništavaju pohranjenu vrijednost ako postoji; nakon toga nemoj upotrebljavati pokazivače ni reference na nju.
U lekciji 51 std::numeric_limits<int> iz <limits> daje granice tipa int: max() vraća najveću, a min() najmanju prikazivu vrijednost. Za tipove s pomičnim zarezom sa subnormalnim vrijednostima min() vraća najmanju pozitivnu normaliziranu vrijednost; lowest() vraća najmanju konačnu vrijednost. Primjer provjerava granicu koja odgovara predznaku b prije izračuna a + b. Zahvaljujući kratkospojnom vrednovanju operatora &&, sama oduzimanja ostaju unutar raspona. Zbroj tipa int izvan raspona imao bi nedefinirano ponašanje.
U lekciji 48 std::filesystem::perms iz <filesystem> enumeracijski je tip enum class koji služi kao bitna maska dozvola za datoteke. Prisutna vrijednost std::filesystem::perms::none znači da nije postavljen nijedan bit dozvola; prazan std::optional<std::filesystem::perms> znači da nema rezultata. To je samo kontekst: primjer ne upotrebljava taj tip te ne provjerava niti provodi dozvole.
Primjeri
#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));
}Rezultat
0 no result no result
Prvi poziv ispisuje `0`; sljedeća dva ispisuju svaki po jedan `no result` jer je zbroj izvan raspona tipa `int`.
Povezane lekcije
- C++ · Lekcija 48 · Napredno · Verzija: 3
- C++ · Lekcija 51 · Napredno · Verzija: 3
Izvori
- 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]