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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.