CKTIS / C++
std::nullopt — einen fehlenden Wert explizit angeben
Mit `std::nullopt` gibst du ein leeres `std::optional` zurück oder leerst es, ohne ein fehlendes Ergebnis mit einem gültigen Wert wie null zu verwechseln.
Version: 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 ist eine inline constexpr-Konstante vom Typ std::nullopt_t aus <optional> und seit C++17 verfügbar. Der Konstruktor, der diesen Marker annimmt, erzeugt ein leeres std::optional<T>, ohne ein T zu konstruieren. Verwende return std::nullopt;, wenn eine Funktion std::optional<T> zurückgibt und kein Ergebnis vorliegt. Warum das Ergebnis fehlt, sagt die Konstante nicht.
o == std::nullopt und !o.has_value() prüfen, ob der Wert fehlt. if (o) prüft, ob ein Wert vorhanden ist, nicht welchen Inhalt er hat: Auch ein gespeichertes 0, false oder nullptr ist ein Wert. Verwende *o und o-> nur bei vorhandenem Wert. Bei einem leeren Optional haben diese Operatoren in C++23 undefiniertes Verhalten; o.value() löst dagegen std::bad_optional_access aus. Sowohl o = std::nullopt als auch o.reset() zerstören den gegebenenfalls enthaltenen Wert. Verwende Zeiger oder Referenzen auf diesen Wert danach nicht mehr.
In Lektion 51 liefert std::numeric_limits<int> aus <limits> die Grenzen von int: max() ist der größte und min() der kleinste darstellbare Wert. Bei Gleitkommatypen mit subnormalen Werten liefert min() den kleinsten positiven normalisierten Wert; lowest() liefert den kleinsten endlichen Wert. Das Beispiel prüft vor a + b die zum Vorzeichen von b passende Grenze. Durch die Kurzschlussauswertung von && bleiben die Subtraktionen selbst im Wertebereich. Eine int-Summe außerhalb des Wertebereichs hätte undefiniertes Verhalten.
In Lektion 48 ist std::filesystem::perms aus <filesystem> ein enum class-Typ, der als Bitmaske für Dateiberechtigungen dient. Ein vorhandenes std::filesystem::perms::none bedeutet, dass keine Berechtigungsbits gesetzt sind; ein leeres std::optional<std::filesystem::perms> bedeutet, dass kein Ergebnis vorliegt. Das ist nur Kontext: Das Beispiel verwendet diesen Typ nicht und prüft oder erzwingt keine Berechtigungen.
Beispiele
#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));
}Ergebnis
0 no result no result
Der erste Aufruf gibt `0` aus. Die beiden folgenden geben jeweils `no result` aus, weil die Summe außerhalb des Wertebereichs von `int` liegt.
Zugehörige Lektionen
- C++ · Lektion 48 · Fortgeschritten · Version: 3
- C++ · Lektion 51 · Fortgeschritten · Version: 3
Quellen
- 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]