CKTIS / C++
std::nullopt — expliciet aangeven dat een waarde ontbreekt
Gebruik `std::nullopt` om een lege `std::optional` terug te geven of leeg te maken, zonder een ontbrekend resultaat te verwarren met een geldige waarde zoals nul.
Versie: 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 is een inline constexpr-constante van het type std::nullopt_t uit <optional>, beschikbaar sinds C++17. De constructor die deze markering accepteert, maakt een lege std::optional<T> zonder een object van het type T te construeren. Gebruik return std::nullopt; als een functie std::optional<T> teruggeeft en er geen resultaat is. De constante zegt niet waarom het resultaat ontbreekt.
o == std::nullopt en !o.has_value() testen of de waarde ontbreekt. if (o) test de aanwezigheid, niet de inhoud: een opgeslagen 0, false of nullptr is nog steeds een aanwezige waarde. Gebruik *o en o-> alleen als er een waarde is. In C++23 hebben deze operatoren ongedefinieerd gedrag bij een leeg object, terwijl o.value() dan std::bad_optional_access gooit. Zowel o = std::nullopt als o.reset() vernietigt de eventuele opgeslagen waarde. Gebruik daarna geen pointers of referenties meer naar die waarde.
In les 51 levert std::numeric_limits<int> uit <limits> de grenzen van int: max() geeft de grootste en min() de kleinste representeerbare waarde. Voor drijvendekommatypen met subnormale waarden geeft min() de kleinste positieve genormaliseerde waarde; lowest() geeft de laagste eindige waarde. Het voorbeeld controleert de grens die bij het teken van b hoort voordat het a + b evalueert. Dankzij kortsluitevaluatie van && blijven de aftrekkingen zelf binnen het bereik. Een int-som buiten het bereik zou ongedefinieerd gedrag hebben.
In les 48 is std::filesystem::perms uit <filesystem> een enum class-type dat als bitmasker voor bestandsrechten dient. Een aanwezige waarde std::filesystem::perms::none betekent dat er geen rechtenbits zijn ingesteld; een lege std::optional<std::filesystem::perms> betekent dat er geen resultaat is. Dit is alleen context: het voorbeeld gebruikt dit type niet en controleert of handhaaft geen rechten.
Voorbeelden
#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));
}Resultaat
0 no result no result
De eerste aanroep schrijft `0`; de volgende twee schrijven elk `no result`, omdat de som buiten het bereik van `int` valt.
Gerelateerde lessen
- C++ · Les 48 · Gevorderd · Versie: 3
- C++ · Les 51 · Gevorderd · Versie: 3
Bronnen
- 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]