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

CKTIS / C++

std::optional — стойност, която може да липсва

std::optional<T> представя обект от тип T или липса на стойност. Така можете да разграничите липсващ резултат от валидни стойности като 0. Проверете дали има стойност, преди да използвате операторите * и ->.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <optional>
std::optional<T> item;
std::optional<T> empty = std::nullopt;
if (item) { /* *item; item->member; */ }

std::optional<T>, деклариран в <optional>, съхранява стойност от тип T в собствения си обект или не съдържа стойност. Полезен е, когато функцията може да не върне резултат, но не ви е нужно описание на грешката. Конструирането по подразбиране с std::optional<T> item; създава празно състояние; конструирането със стойност от тип T създава състояние, което съдържа стойност.

std::nullopt е константата, която обозначава липса на стойност, а std::nullopt_t е нейният отделен маркерен тип, а не типът на съхранения резултат. Използвайте return std::nullopt;, за да върнете празен резултат, или item = std::nullopt;, за да премахнете съхранената стойност.

std::optional::operator bool е явна конверсия, която проверява дали има стойност; тя работи в if (item), подобно на item.has_value(). Не проверява самата съхранена стойност: обект, съдържащ 0 или false, все пак дава true.

std::optional::operator* предоставя достъп до съхранената стойност чрез референция, а std::optional::operator-> позволява достъп до нейните членове. И двата оператора изискват да има стойност. В C++23 използването на който и да е от тях върху празен обект води до неопределено поведение; не очаквайте изключение. Методът value() проверява това състояние и хвърля std::bad_optional_access, когато няма стойност.

Този запис е за C++23: флага на компилатора в хранилището, без потвърждение за производствената среда на изпълнение. Свързаният работен проект на стандарта се актуализира и включва и по-късни разширения; цялото му съдържание не бива да се счита за C++23.

Примери

#include <iostream>
#include <optional>

struct Item {
    int count;
};

std::optional<Item> find_item(bool available) {
    if (available) {
        return Item{0};
    }
    return std::nullopt;
}

int main() {
    const auto item = find_item(true);
    if (item) {
        std::cout << item->count << ' ' << (*item).count << '\n';
    }

    const auto missing = find_item(false);
    std::cout << std::boolalpha << missing.has_value() << '\n';
}

Резултат

0 0
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници