CKTIS / C++
std::nullopt — výslovné označenie chýbajúcej hodnoty
Pomocou `std::nullopt` vráť alebo vyprázdni `std::optional` bez toho, aby si si pomýlil chýbajúci výsledok s platnou hodnotou, napríklad nulou.
Verzia: ISO C++23; implementation support may vary
Syntax
#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 konštanta inline constexpr typu std::nullopt_t z hlavičky <optional>, dostupná od C++17. Konštruktor, ktorý prijíma túto značku, vytvorí prázdny std::optional<T> bez vytvorenia objektu typu T. Použi return std::nullopt;, keď funkcia vracia std::optional<T> a nemá žiadny výsledok. Samotná konštanta nehovorí, prečo výsledok chýba.
o == std::nullopt a !o.has_value() testujú, či hodnota chýba. if (o) testuje prítomnosť, nie obsah: uložené 0, false alebo nullptr je stále prítomná hodnota. Operátory *o a o-> používaj iba pri prítomnej hodnote. V C++23 majú pri prázdnom objekte nedefinované správanie, zatiaľ čo o.value() vyvolá výnimku std::bad_optional_access. o = std::nullopt aj o.reset() zničia prípadnú uloženú hodnotu; ukazovatele ani referencie na ňu potom nepoužívaj.
V lekcii 51 poskytuje std::numeric_limits<int> z <limits> hranice typu int: max() vracia najväčšiu a min() najmenšiu reprezentovateľnú hodnotu. Pri typoch s pohyblivou rádovou čiarkou so subnormálnymi hodnotami vracia min() najmenšiu kladnú normalizovanú hodnotu; lowest() vracia najmenšiu konečnú hodnotu. Príklad skontroluje hranicu zodpovedajúcu znamienku b pred vyhodnotením a + b. Vďaka skrátenému vyhodnocovaniu && zostanú v rozsahu aj samotné odčítania. Súčet typu int mimo rozsahu by mal nedefinované správanie.
V lekcii 48 je std::filesystem::perms z <filesystem> výčtový typ enum class, ktorý slúži ako bitová maska oprávnení k súborom. Prítomná hodnota std::filesystem::perms::none znamená, že nie je nastavený žiadny bit oprávnení; prázdny std::optional<std::filesystem::perms> znamená, že výsledok chýba. Je to iba kontext: príklad tento typ nepoužíva a oprávnenia nekontroluje ani nevynucuje.
Prí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ýsledok
0 no result no result
Prvé volanie vypíše `0`; ďalšie dve vypíšu každé `no result`, pretože súčet je mimo rozsahu typu `int`.
Súvisiace lekcie
- C++ · Lekcia 48 · Pokročilá · Verzia: 3
- C++ · Lekcia 51 · Pokročilá · Verzia: 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]