База знанияИзпитен център
BGБългарски
Избери език13

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

Източници