CKTIS / C++
std::nullopt — явно обозначаване на липсваща стойност
Използвай `std::nullopt`, за да върнеш или изпразниш `std::optional`, без да объркваш липсващ резултат с валидна стойност като нула.
Версия: ISO C++23; implementation support may vary
Синтаксис
#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 е константа inline constexpr от тип std::nullopt_t, дефинирана в заглавния файл <optional> и налична от C++17. Конструкторът, който приема този маркер, създава празен std::optional<T>, без да конструира обект от тип T. Използвай return std::nullopt;, когато функцията връща std::optional<T>, но няма резултат. Самата константа не уточнява защо резултатът липсва.
o == std::nullopt и !o.has_value() проверяват дали стойността липсва. if (o) проверява наличието, а не съдържанието: съхранените 0, false и nullptr също са налични стойности. Използвай *o и o-> само ако има стойност. В C++23 тези оператори имат неопределено поведение при празен обект, докато o.value() хвърля std::bad_optional_access. И o = std::nullopt, и o.reset() унищожават съхранената стойност, ако има такава; след това не използвай указатели или референции към нея.
В урок 51 std::numeric_limits<int> от <limits> дава границите на int: max() връща най-голямата, а min() — най-малката представима стойност. При типовете с плаваща запетая със субнормални стойности min() връща най-малката положителна нормализирана стойност; lowest() връща най-малката крайна стойност. Примерът проверява границата според знака на b, преди да изчисли a + b. Благодарение на съкратеното изчисляване на && самите изваждания остават в диапазона. Сума от тип int извън диапазона би довела до неопределено поведение.
В урок 48 std::filesystem::perms от <filesystem> е изброим тип enum class, използван като битова маска за права върху файлове. Налична стойност std::filesystem::perms::none означава, че няма зададени битове за права; празен std::optional<std::filesystem::perms> означава, че няма резултат. Това е само контекст: примерът не използва този тип и не проверява или налага права за достъп.
Примери
#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));
}Резултат
0 no result no result
Първото извикване отпечатва `0`; следващите две отпечатват по един ред `no result`, защото сумата е извън диапазона на `int`.
Свързани уроци
- C++ · Урок 48 · Напреднало · Версия: 3
- C++ · Урок 51 · Напреднало · Версия: 3
Източници
- 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]