908 lines
30 KiB
Plaintext
908 lines
30 KiB
Plaintext
// Copyright 2017 Dolphin Emulator Project
|
|
// Licensed under GPLv2+
|
|
// Refer to the license.txt file included.
|
|
|
|
#pragma once
|
|
|
|
#if __has_include_next(<optional>)
|
|
#include_next <optional>
|
|
#else
|
|
/* Copyright 2017 The TensorFlow Authors. All Rights Reserved.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
==============================================================================*/
|
|
|
|
#include <cassert>
|
|
#include <functional>
|
|
#include <initializer_list>
|
|
#include <type_traits>
|
|
#include <utility>
|
|
|
|
#ifndef __has_feature
|
|
#define __has_feature(x) 0
|
|
#endif
|
|
|
|
#if __has_feature(cxx_exceptions) || defined(__cpp_exceptions)
|
|
#define GTL_HAS_EXCEPTIONS
|
|
#endif
|
|
|
|
namespace gtl {
|
|
|
|
// A value of type gtl::optional<T> holds either a value of T or an
|
|
// "empty" value. When it holds a value of T, it stores it as a direct
|
|
// subobject, so sizeof(optional<T>) is approximately sizeof(T)+1. The interface
|
|
// is based on the upcoming std::optional<T>, and gtl::optional<T> is
|
|
// designed to be cheaply drop-in replaceable by std::optional<T>, once it is
|
|
// rolled out.
|
|
//
|
|
// This implementation is based on the specification in the latest draft as of
|
|
// 2017-01-05, section 20.6.
|
|
//
|
|
// Differences between gtl::optional<T> and std::optional<T> include:
|
|
// - constexpr not used for nonconst member functions.
|
|
// (dependency on some differences between C++11 and C++14.)
|
|
// - nullopt and in_place are not constexpr. We need the inline variable
|
|
// support in C++17 for external linkage.
|
|
// - optional::swap() and swap() relies on std::is_(nothrow_)swappable
|
|
// which is introduced in C++17. So we assume is_swappable is always true
|
|
// and is_nothrow_swappable is same as std::is_trivial.
|
|
// - make_optional cannot be constexpr due to absence of guaranteed copy
|
|
// elision.
|
|
//
|
|
// Synopsis:
|
|
//
|
|
// #include "tensorflow/core/lib/gtl/optional.h"
|
|
//
|
|
// tensorflow::gtl::optional<string> f() {
|
|
// string result;
|
|
// if (...) {
|
|
// ...
|
|
// result = ...;
|
|
// return result;
|
|
// } else {
|
|
// ...
|
|
// return tensorflow::gtl::nullopt;
|
|
// }
|
|
// }
|
|
//
|
|
// int main() {
|
|
// tensorflow::gtl::optional<string> optstr = f();
|
|
// if (optstr) {
|
|
// // non-empty
|
|
// print(optstr.value());
|
|
// } else {
|
|
// // empty
|
|
// error();
|
|
// }
|
|
// }
|
|
template <typename T>
|
|
class optional;
|
|
|
|
// The tag constant `in_place` is used as the first parameter of an optional<T>
|
|
// constructor to indicate that the remaining arguments should be forwarded
|
|
// to the underlying T constructor.
|
|
struct in_place_t {};
|
|
extern const in_place_t in_place;
|
|
|
|
// The tag constant `nullopt` is used to indicate an empty optional<T> in
|
|
// certain functions, such as construction or assignment.
|
|
struct nullopt_t {
|
|
struct init_t {};
|
|
static init_t init;
|
|
// It must not be default-constructible to avoid ambiguity for opt = {}.
|
|
// Note the non-const reference, it is to eliminate ambiguity for code like:
|
|
// struct S { int value; };
|
|
//
|
|
// void Test() {
|
|
// optional<S> opt;
|
|
// opt = {{}};
|
|
// }
|
|
explicit constexpr nullopt_t(init_t& /*unused*/) {} // NOLINT
|
|
};
|
|
extern const nullopt_t nullopt;
|
|
|
|
class bad_optional_access : public std::exception
|
|
{
|
|
public:
|
|
virtual const char* what() const noexcept { return "bad_optional_access"; }
|
|
};
|
|
|
|
[[noreturn]] inline void throw_bad_optional_access()
|
|
{
|
|
#ifdef GTL_HAS_EXCEPTIONS
|
|
throw bad_optional_access{};
|
|
#else
|
|
std::terminate();
|
|
#endif
|
|
}
|
|
|
|
namespace internal_optional {
|
|
|
|
// define forward locally because std::forward is not constexpr until C++14
|
|
template <typename T>
|
|
constexpr T&& forward(typename std::remove_reference<T>::type&
|
|
t) noexcept { // NOLINT(runtime/references)
|
|
return static_cast<T&&>(t);
|
|
}
|
|
|
|
struct empty_struct {};
|
|
// This class stores the data in optional<T>.
|
|
// It is specialized based on whether T is trivially destructible.
|
|
// This is the specialization for non trivially destructible type.
|
|
template <typename T, bool = std::is_trivially_destructible<T>::value>
|
|
class optional_data_dtor_base {
|
|
protected:
|
|
// Whether there is data or not.
|
|
bool engaged_;
|
|
// data storage
|
|
union {
|
|
empty_struct dummy_;
|
|
T data_;
|
|
};
|
|
|
|
void destruct() noexcept {
|
|
if (engaged_) {
|
|
data_.~T();
|
|
engaged_ = false;
|
|
}
|
|
}
|
|
|
|
// dummy_ must be initialized for constexpr constructor
|
|
constexpr optional_data_dtor_base() noexcept : engaged_(false), dummy_{} {}
|
|
|
|
template <typename... Args>
|
|
constexpr explicit optional_data_dtor_base(in_place_t, Args&&... args)
|
|
: engaged_(true), data_(internal_optional::forward<Args>(args)...) {}
|
|
|
|
~optional_data_dtor_base() { destruct(); }
|
|
};
|
|
|
|
// Specialization for trivially destructible type.
|
|
template <typename T>
|
|
class optional_data_dtor_base<T, true> {
|
|
protected:
|
|
// Whether there is data or not.
|
|
bool engaged_;
|
|
// data storage
|
|
union {
|
|
empty_struct dummy_;
|
|
T data_;
|
|
};
|
|
void destruct() noexcept { engaged_ = false; }
|
|
|
|
// dummy_ must be initialized for constexpr constructor
|
|
constexpr optional_data_dtor_base() noexcept : engaged_(false), dummy_{} {}
|
|
|
|
template <typename... Args>
|
|
constexpr explicit optional_data_dtor_base(in_place_t, Args&&... args)
|
|
: engaged_(true), data_(internal_optional::forward<Args>(args)...) {}
|
|
|
|
~optional_data_dtor_base() = default;
|
|
};
|
|
|
|
template <typename T>
|
|
class optional_data : public optional_data_dtor_base<T> {
|
|
protected:
|
|
using base = optional_data_dtor_base<T>;
|
|
using base::base;
|
|
|
|
T* pointer() { return &this->data_; }
|
|
|
|
constexpr const T* pointer() const { return &this->data_; }
|
|
|
|
template <typename... Args>
|
|
void construct(Args&&... args) {
|
|
new (pointer()) T(std::forward<Args>(args)...);
|
|
this->engaged_ = true;
|
|
}
|
|
|
|
template <typename U>
|
|
void assign(U&& u) {
|
|
if (this->engaged_) {
|
|
this->data_ = std::forward<U>(u);
|
|
} else {
|
|
construct(std::forward<U>(u));
|
|
}
|
|
}
|
|
|
|
optional_data() = default;
|
|
|
|
optional_data(const optional_data& rhs) {
|
|
if (rhs.engaged_) {
|
|
construct(rhs.data_);
|
|
}
|
|
}
|
|
|
|
optional_data(optional_data&& rhs) noexcept(
|
|
std::is_nothrow_move_constructible<T>::value) {
|
|
if (rhs.engaged_) {
|
|
construct(std::move(rhs.data_));
|
|
}
|
|
}
|
|
|
|
optional_data& operator=(const optional_data& rhs) {
|
|
if (rhs.engaged_) {
|
|
assign(rhs.data_);
|
|
} else {
|
|
this->destruct();
|
|
}
|
|
return *this;
|
|
}
|
|
|
|
optional_data& operator=(optional_data&& rhs) noexcept(
|
|
std::is_nothrow_move_assignable<T>::value&&
|
|
std::is_nothrow_move_constructible<T>::value) {
|
|
if (rhs.engaged_) {
|
|
assign(std::move(rhs.data_));
|
|
} else {
|
|
this->destruct();
|
|
}
|
|
return *this;
|
|
}
|
|
};
|
|
|
|
// ordered by level of restriction, from low to high.
|
|
// copyable implies movable.
|
|
enum class copy_traits { copyable = 0, movable = 1, non_movable = 2 };
|
|
|
|
// base class for enabling/disabling copy/move constructor.
|
|
template <copy_traits>
|
|
class optional_ctor_base;
|
|
|
|
template <>
|
|
class optional_ctor_base<copy_traits::copyable> {
|
|
public:
|
|
constexpr optional_ctor_base() = default;
|
|
optional_ctor_base(const optional_ctor_base&) = default;
|
|
optional_ctor_base(optional_ctor_base&&) = default;
|
|
optional_ctor_base& operator=(const optional_ctor_base&) = default;
|
|
optional_ctor_base& operator=(optional_ctor_base&&) = default;
|
|
};
|
|
|
|
template <>
|
|
class optional_ctor_base<copy_traits::movable> {
|
|
public:
|
|
constexpr optional_ctor_base() = default;
|
|
optional_ctor_base(const optional_ctor_base&) = delete;
|
|
optional_ctor_base(optional_ctor_base&&) = default;
|
|
optional_ctor_base& operator=(const optional_ctor_base&) = default;
|
|
optional_ctor_base& operator=(optional_ctor_base&&) = default;
|
|
};
|
|
|
|
template <>
|
|
class optional_ctor_base<copy_traits::non_movable> {
|
|
public:
|
|
constexpr optional_ctor_base() = default;
|
|
optional_ctor_base(const optional_ctor_base&) = delete;
|
|
optional_ctor_base(optional_ctor_base&&) = delete;
|
|
optional_ctor_base& operator=(const optional_ctor_base&) = default;
|
|
optional_ctor_base& operator=(optional_ctor_base&&) = default;
|
|
};
|
|
|
|
// base class for enabling/disabling copy/move assignment.
|
|
template <copy_traits>
|
|
class optional_assign_base;
|
|
|
|
template <>
|
|
class optional_assign_base<copy_traits::copyable> {
|
|
public:
|
|
constexpr optional_assign_base() = default;
|
|
optional_assign_base(const optional_assign_base&) = default;
|
|
optional_assign_base(optional_assign_base&&) = default;
|
|
optional_assign_base& operator=(const optional_assign_base&) = default;
|
|
optional_assign_base& operator=(optional_assign_base&&) = default;
|
|
};
|
|
|
|
template <>
|
|
class optional_assign_base<copy_traits::movable> {
|
|
public:
|
|
constexpr optional_assign_base() = default;
|
|
optional_assign_base(const optional_assign_base&) = default;
|
|
optional_assign_base(optional_assign_base&&) = default;
|
|
optional_assign_base& operator=(const optional_assign_base&) = delete;
|
|
optional_assign_base& operator=(optional_assign_base&&) = default;
|
|
};
|
|
|
|
template <>
|
|
class optional_assign_base<copy_traits::non_movable> {
|
|
public:
|
|
constexpr optional_assign_base() = default;
|
|
optional_assign_base(const optional_assign_base&) = default;
|
|
optional_assign_base(optional_assign_base&&) = default;
|
|
optional_assign_base& operator=(const optional_assign_base&) = delete;
|
|
optional_assign_base& operator=(optional_assign_base&&) = delete;
|
|
};
|
|
|
|
template <typename T>
|
|
constexpr copy_traits get_ctor_copy_traits() {
|
|
return std::is_copy_constructible<T>::value
|
|
? copy_traits::copyable
|
|
: std::is_move_constructible<T>::value ? copy_traits::movable
|
|
: copy_traits::non_movable;
|
|
}
|
|
|
|
template <typename T>
|
|
constexpr copy_traits get_assign_copy_traits() {
|
|
return std::is_copy_assignable<T>::value &&
|
|
std::is_copy_constructible<T>::value
|
|
? copy_traits::copyable
|
|
: std::is_move_assignable<T>::value &&
|
|
std::is_move_constructible<T>::value
|
|
? copy_traits::movable
|
|
: copy_traits::non_movable;
|
|
}
|
|
|
|
// Whether T is constructible or convertible from optional<U>.
|
|
template <typename T, typename U>
|
|
struct is_constructible_convertible_from_optional
|
|
: std::integral_constant<
|
|
bool, std::is_constructible<T, optional<U>&>::value ||
|
|
std::is_constructible<T, optional<U>&&>::value ||
|
|
std::is_constructible<T, const optional<U>&>::value ||
|
|
std::is_constructible<T, const optional<U>&&>::value ||
|
|
std::is_convertible<optional<U>&, T>::value ||
|
|
std::is_convertible<optional<U>&&, T>::value ||
|
|
std::is_convertible<const optional<U>&, T>::value ||
|
|
std::is_convertible<const optional<U>&&, T>::value> {};
|
|
|
|
// Whether T is constructible or convertible or assignable from optional<U>.
|
|
template <typename T, typename U>
|
|
struct is_constructible_convertible_assignable_from_optional
|
|
: std::integral_constant<
|
|
bool, is_constructible_convertible_from_optional<T, U>::value ||
|
|
std::is_assignable<T&, optional<U>&>::value ||
|
|
std::is_assignable<T&, optional<U>&&>::value ||
|
|
std::is_assignable<T&, const optional<U>&>::value ||
|
|
std::is_assignable<T&, const optional<U>&&>::value> {};
|
|
|
|
} // namespace internal_optional
|
|
|
|
template <typename T>
|
|
class optional : private internal_optional::optional_data<T>,
|
|
private internal_optional::optional_ctor_base<
|
|
internal_optional::get_ctor_copy_traits<T>()>,
|
|
private internal_optional::optional_assign_base<
|
|
internal_optional::get_assign_copy_traits<T>()> {
|
|
using data_base = internal_optional::optional_data<T>;
|
|
|
|
public:
|
|
typedef T value_type;
|
|
|
|
// [optional.ctor], constructors
|
|
|
|
// A default constructed optional holds the empty value, NOT a default
|
|
// constructed T.
|
|
constexpr optional() noexcept {}
|
|
|
|
// An optional initialized with `nullopt` holds the empty value.
|
|
constexpr optional(nullopt_t) noexcept {} // NOLINT(runtime/explicit)
|
|
|
|
// Copy constructor, standard semantics.
|
|
optional(const optional& src) = default;
|
|
|
|
// Move constructor, standard semantics.
|
|
optional(optional&& src) = default;
|
|
|
|
// optional<T>(in_place, arg1, arg2, arg3) constructs a non-empty optional
|
|
// with an in-place constructed value of T(arg1,arg2,arg3).
|
|
// TODO(b/34201852): Add std::is_constructible<T, Args&&...> SFINAE.
|
|
template <typename... Args>
|
|
constexpr explicit optional(in_place_t, Args&&... args)
|
|
: data_base(in_place_t(), internal_optional::forward<Args>(args)...) {}
|
|
|
|
// optional<T>(in_place, {arg1, arg2, arg3}) constructs a non-empty optional
|
|
// with an in-place list-initialized value of T({arg1, arg2, arg3}).
|
|
template <typename U, typename... Args,
|
|
typename = typename std::enable_if<std::is_constructible<
|
|
T, std::initializer_list<U>&, Args&&...>::value>::type>
|
|
constexpr explicit optional(in_place_t, std::initializer_list<U> il,
|
|
Args&&... args)
|
|
: data_base(in_place_t(), il, internal_optional::forward<Args>(args)...) {
|
|
}
|
|
|
|
template <
|
|
typename U = T,
|
|
typename std::enable_if<
|
|
std::is_constructible<T, U&&>::value &&
|
|
!std::is_same<in_place_t, typename std::decay<U>::type>::value &&
|
|
!std::is_same<optional<T>, typename std::decay<U>::type>::value &&
|
|
std::is_convertible<U&&, T>::value,
|
|
bool>::type = false>
|
|
constexpr optional(U&& v) // NOLINT
|
|
: data_base(in_place_t(), internal_optional::forward<U>(v)) {}
|
|
|
|
template <
|
|
typename U = T,
|
|
typename std::enable_if<
|
|
std::is_constructible<T, U&&>::value &&
|
|
!std::is_same<in_place_t, typename std::decay<U>::type>::value &&
|
|
!std::is_same<optional<T>, typename std::decay<U>::type>::value &&
|
|
!std::is_convertible<U&&, T>::value,
|
|
bool>::type = false>
|
|
explicit constexpr optional(U&& v)
|
|
: data_base(in_place_t(), internal_optional::forward<U>(v)) {}
|
|
|
|
// Converting copy constructor (implicit)
|
|
template <
|
|
typename U,
|
|
typename std::enable_if<
|
|
std::is_constructible<T, const U&>::value &&
|
|
!internal_optional::is_constructible_convertible_from_optional<
|
|
T, U>::value &&
|
|
std::is_convertible<const U&, T>::value,
|
|
bool>::type = false>
|
|
optional(const optional<U>& rhs) { // NOLINT
|
|
if (rhs) {
|
|
this->construct(*rhs);
|
|
}
|
|
}
|
|
|
|
// Converting copy constructor (explicit)
|
|
template <
|
|
typename U,
|
|
typename std::enable_if<
|
|
std::is_constructible<T, const U&>::value &&
|
|
!internal_optional::is_constructible_convertible_from_optional<
|
|
T, U>::value &&
|
|
!std::is_convertible<const U&, T>::value,
|
|
bool>::type = false>
|
|
explicit optional(const optional<U>& rhs) {
|
|
if (rhs) {
|
|
this->construct(*rhs);
|
|
}
|
|
}
|
|
|
|
// Converting move constructor (implicit)
|
|
template <
|
|
typename U,
|
|
typename std::enable_if<
|
|
std::is_constructible<T, U&&>::value &&
|
|
!internal_optional::is_constructible_convertible_from_optional<
|
|
T, U>::value &&
|
|
std::is_convertible<U&&, T>::value,
|
|
bool>::type = false>
|
|
optional(optional<U>&& rhs) { // NOLINT
|
|
if (rhs) {
|
|
this->construct(std::move(*rhs));
|
|
}
|
|
}
|
|
|
|
// Converting move constructor (explicit)
|
|
template <
|
|
typename U,
|
|
typename std::enable_if<
|
|
std::is_constructible<T, U&&>::value &&
|
|
!internal_optional::is_constructible_convertible_from_optional<
|
|
T, U>::value &&
|
|
!std::is_convertible<U&&, T>::value,
|
|
bool>::type = false>
|
|
explicit optional(optional<U>&& rhs) {
|
|
if (rhs) {
|
|
this->construct(std::move(*rhs));
|
|
}
|
|
}
|
|
|
|
// [optional.dtor], destructor, trivial if T is trivially destructible.
|
|
~optional() = default;
|
|
|
|
// [optional.assign], assignment
|
|
|
|
// Assignment from nullopt: opt = nullopt
|
|
optional& operator=(nullopt_t) noexcept {
|
|
this->destruct();
|
|
return *this;
|
|
}
|
|
|
|
// Copy assigment, standard semantics.
|
|
optional& operator=(const optional& src) = default;
|
|
|
|
// Move assignment, standard semantics.
|
|
optional& operator=(optional&& src) = default;
|
|
|
|
// Value assignment
|
|
template <
|
|
typename U = T,
|
|
typename = typename std::enable_if<
|
|
!std::is_same<optional<T>, typename std::decay<U>::type>::value &&
|
|
(!std::is_scalar<T>::value ||
|
|
!std::is_same<T, typename std::decay<U>::type>::value) &&
|
|
std::is_constructible<T, U>::value &&
|
|
std::is_assignable<T&, U>::value>::type>
|
|
optional& operator=(U&& v) {
|
|
this->assign(std::forward<U>(v));
|
|
return *this;
|
|
}
|
|
|
|
template <typename U,
|
|
typename = typename std::enable_if<
|
|
std::is_constructible<T, const U&>::value &&
|
|
std::is_assignable<T&, const U&>::value &&
|
|
!internal_optional::
|
|
is_constructible_convertible_assignable_from_optional<
|
|
T, U>::value>::type>
|
|
optional& operator=(const optional<U>& rhs) {
|
|
if (rhs) {
|
|
this->assign(*rhs);
|
|
} else {
|
|
this->destruct();
|
|
}
|
|
return *this;
|
|
}
|
|
|
|
template <typename U,
|
|
typename = typename std::enable_if<
|
|
std::is_constructible<T, U>::value &&
|
|
std::is_assignable<T&, U>::value &&
|
|
!internal_optional::
|
|
is_constructible_convertible_assignable_from_optional<
|
|
T, U>::value>::type>
|
|
optional& operator=(optional<U>&& rhs) {
|
|
if (rhs) {
|
|
this->assign(std::move(*rhs));
|
|
} else {
|
|
this->destruct();
|
|
}
|
|
return *this;
|
|
}
|
|
|
|
// [optional.mod], modifiers
|
|
// Destroys the inner T value if one is present.
|
|
void reset() noexcept { this->destruct(); }
|
|
|
|
// Emplace reconstruction. (Re)constructs the underlying T in-place with the
|
|
// given arguments forwarded:
|
|
//
|
|
// optional<Foo> opt;
|
|
// opt.emplace(arg1,arg2,arg3); (Constructs Foo(arg1,arg2,arg3))
|
|
//
|
|
// If the optional is non-empty, and the `args` refer to subobjects of the
|
|
// current object, then behavior is undefined. This is because the current
|
|
// object will be destructed before the new object is constructed with `args`.
|
|
//
|
|
template <typename... Args,
|
|
typename = typename std::enable_if<
|
|
std::is_constructible<T, Args&&...>::value>::type>
|
|
void emplace(Args&&... args) {
|
|
this->destruct();
|
|
this->construct(std::forward<Args>(args)...);
|
|
}
|
|
|
|
// Emplace reconstruction with initializer-list. See immediately above.
|
|
template <class U, class... Args,
|
|
typename = typename std::enable_if<std::is_constructible<
|
|
T, std::initializer_list<U>&, Args&&...>::value>::type>
|
|
void emplace(std::initializer_list<U> il, Args&&... args) {
|
|
this->destruct();
|
|
this->construct(il, std::forward<Args>(args)...);
|
|
}
|
|
|
|
// [optional.swap], swap
|
|
// Swap, standard semantics.
|
|
void swap(optional& rhs) noexcept(
|
|
std::is_nothrow_move_constructible<T>::value&&
|
|
std::is_trivial<T>::value) {
|
|
if (*this) {
|
|
if (rhs) {
|
|
using std::swap;
|
|
swap(**this, *rhs);
|
|
} else {
|
|
rhs.construct(std::move(**this));
|
|
this->destruct();
|
|
}
|
|
} else {
|
|
if (rhs) {
|
|
this->construct(std::move(*rhs));
|
|
rhs.destruct();
|
|
} else {
|
|
// no effect (swap(disengaged, disengaged))
|
|
}
|
|
}
|
|
}
|
|
|
|
// [optional.observe], observers
|
|
// You may use `*opt`, and `opt->m`, to access the underlying T value and T's
|
|
// member `m`, respectively. If the optional is empty, behavior is
|
|
// undefined.
|
|
constexpr const T* operator->() const { return this->pointer(); }
|
|
T* operator->() {
|
|
assert(this->engaged_);
|
|
return this->pointer();
|
|
}
|
|
constexpr const T& operator*() const & { return reference(); }
|
|
T& operator*() & {
|
|
assert(this->engaged_);
|
|
return reference();
|
|
}
|
|
constexpr const T&& operator*() const && { return std::move(reference()); }
|
|
T&& operator*() && {
|
|
assert(this->engaged_);
|
|
return std::move(reference());
|
|
}
|
|
|
|
// In a bool context an optional<T> will return false if and only if it is
|
|
// empty.
|
|
//
|
|
// if (opt) {
|
|
// // do something with opt.value();
|
|
// } else {
|
|
// // opt is empty
|
|
// }
|
|
//
|
|
constexpr explicit operator bool() const noexcept { return this->engaged_; }
|
|
|
|
// Returns false if and only if *this is empty.
|
|
constexpr bool has_value() const noexcept { return this->engaged_; }
|
|
|
|
// Use `opt.value()` to get a reference to underlying value. The constness
|
|
// and lvalue/rvalue-ness of `opt` is preserved to the view of the T
|
|
// subobject.
|
|
const T& value() const & {
|
|
if (!*this)
|
|
throw_bad_optional_access();
|
|
return reference();
|
|
}
|
|
T& value() & {
|
|
if (!*this)
|
|
throw_bad_optional_access();
|
|
return reference();
|
|
}
|
|
T&& value() && { // NOLINT(build/c++11)
|
|
if (!*this)
|
|
throw_bad_optional_access();
|
|
return std::move(reference());
|
|
}
|
|
const T&& value() const && { // NOLINT(build/c++11)
|
|
if (!*this)
|
|
throw_bad_optional_access();
|
|
return std::move(reference());
|
|
}
|
|
|
|
// Use `opt.value_or(val)` to get either the value of T or the given default
|
|
// `val` in the empty case.
|
|
template <class U>
|
|
constexpr T value_or(U&& v) const & {
|
|
return static_cast<bool>(*this) ? **this
|
|
: static_cast<T>(std::forward<U>(v));
|
|
}
|
|
template <class U>
|
|
T value_or(U&& v) && { // NOLINT(build/c++11)
|
|
return static_cast<bool>(*this) ? std::move(**this)
|
|
: static_cast<T>(std::forward<U>(v));
|
|
}
|
|
|
|
private:
|
|
// Private accessors for internal storage viewed as reference to T.
|
|
constexpr const T& reference() const { return *this->pointer(); }
|
|
T& reference() { return *(this->pointer()); }
|
|
|
|
// T constaint checks. You can't have an optional of nullopt_t, in_place_t or
|
|
// a reference.
|
|
static_assert(
|
|
!std::is_same<nullopt_t, typename std::remove_cv<T>::type>::value,
|
|
"optional<nullopt_t> is not allowed.");
|
|
static_assert(
|
|
!std::is_same<in_place_t, typename std::remove_cv<T>::type>::value,
|
|
"optional<in_place_t> is not allowed.");
|
|
static_assert(!std::is_reference<T>::value,
|
|
"optional<reference> is not allowed.");
|
|
};
|
|
|
|
// [optional.specalg]
|
|
// Swap, standard semantics.
|
|
// This function shall not participate in overload resolution unless
|
|
// is_move_constructible_v<T> is true and is_swappable_v<T> is true.
|
|
// NOTE: we assume is_swappable is always true. There will be a compiling error
|
|
// if T is actually not Swappable.
|
|
template <typename T,
|
|
typename std::enable_if<std::is_move_constructible<T>::value,
|
|
bool>::type = false>
|
|
void swap(optional<T>& a, optional<T>& b) noexcept(noexcept(a.swap(b))) {
|
|
a.swap(b);
|
|
}
|
|
|
|
// NOTE: make_optional cannot be constexpr in C++11 because the copy/move
|
|
// constructor is not constexpr and we don't have guaranteed copy elision
|
|
// util C++17. But they are still declared constexpr for consistency with
|
|
// the standard.
|
|
|
|
// make_optional(v) creates a non-empty optional<T> where the type T is deduced
|
|
// from v. Can also be explicitly instantiated as make_optional<T>(v).
|
|
template <typename T>
|
|
constexpr optional<typename std::decay<T>::type> make_optional(T&& v) {
|
|
return optional<typename std::decay<T>::type>(std::forward<T>(v));
|
|
}
|
|
|
|
template <typename T, typename... Args>
|
|
constexpr optional<T> make_optional(Args&&... args) {
|
|
return optional<T>(in_place_t(), internal_optional::forward<Args>(args)...);
|
|
}
|
|
|
|
template <typename T, typename U, typename... Args>
|
|
constexpr optional<T> make_optional(std::initializer_list<U> il,
|
|
Args&&... args) {
|
|
return optional<T>(in_place_t(), il,
|
|
internal_optional::forward<Args>(args)...);
|
|
}
|
|
|
|
// Relational operators. Empty optionals are considered equal to each
|
|
// other and less than non-empty optionals. Supports relations between
|
|
// optional<T> and optional<T>, between optional<T> and T, and between
|
|
// optional<T> and nullopt.
|
|
// Note: We're careful to support T having non-bool relationals.
|
|
|
|
// Relational operators [optional.relops]
|
|
// The C++17 (N4606) "Returns:" statements are translated into code
|
|
// in an obvious way here, and the original text retained as function docs.
|
|
// Returns: If bool(x) != bool(y), false; otherwise if bool(x) == false, true;
|
|
// otherwise *x == *y.
|
|
template <class T>
|
|
constexpr bool operator==(const optional<T>& x, const optional<T>& y) {
|
|
return static_cast<bool>(x) != static_cast<bool>(y)
|
|
? false
|
|
: static_cast<bool>(x) == false ? true : *x == *y;
|
|
}
|
|
// Returns: If bool(x) != bool(y), true; otherwise, if bool(x) == false, false;
|
|
// otherwise *x != *y.
|
|
template <class T>
|
|
constexpr bool operator!=(const optional<T>& x, const optional<T>& y) {
|
|
return static_cast<bool>(x) != static_cast<bool>(y)
|
|
? true
|
|
: static_cast<bool>(x) == false ? false : *x != *y;
|
|
}
|
|
// Returns: If !y, false; otherwise, if !x, true; otherwise *x < *y.
|
|
template <class T>
|
|
constexpr bool operator<(const optional<T>& x, const optional<T>& y) {
|
|
return !y ? false : !x ? true : *x < *y;
|
|
}
|
|
// Returns: If !x, false; otherwise, if !y, true; otherwise *x > *y.
|
|
template <class T>
|
|
constexpr bool operator>(const optional<T>& x, const optional<T>& y) {
|
|
return !x ? false : !y ? true : *x > *y;
|
|
}
|
|
// Returns: If !x, true; otherwise, if !y, false; otherwise *x <= *y.
|
|
template <class T>
|
|
constexpr bool operator<=(const optional<T>& x, const optional<T>& y) {
|
|
return !x ? true : !y ? false : *x <= *y;
|
|
}
|
|
// Returns: If !y, true; otherwise, if !x, false; otherwise *x >= *y.
|
|
template <class T>
|
|
constexpr bool operator>=(const optional<T>& x, const optional<T>& y) {
|
|
return !y ? true : !x ? false : *x >= *y;
|
|
}
|
|
|
|
// Comparison with nullopt [optional.nullops]
|
|
// The C++17 (N4606) "Returns:" statements are used directly here.
|
|
template <class T>
|
|
constexpr bool operator==(const optional<T>& x, nullopt_t) noexcept {
|
|
return !x;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator==(nullopt_t, const optional<T>& x) noexcept {
|
|
return !x;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator!=(const optional<T>& x, nullopt_t) noexcept {
|
|
return static_cast<bool>(x);
|
|
}
|
|
template <class T>
|
|
constexpr bool operator!=(nullopt_t, const optional<T>& x) noexcept {
|
|
return static_cast<bool>(x);
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<(const optional<T>& x, nullopt_t) noexcept {
|
|
return false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<(nullopt_t, const optional<T>& x) noexcept {
|
|
return static_cast<bool>(x);
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<=(const optional<T>& x, nullopt_t) noexcept {
|
|
return !x;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<=(nullopt_t, const optional<T>& x) noexcept {
|
|
return true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>(const optional<T>& x, nullopt_t) noexcept {
|
|
return static_cast<bool>(x);
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>(nullopt_t, const optional<T>& x) noexcept {
|
|
return false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>=(const optional<T>& x, nullopt_t) noexcept {
|
|
return true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>=(nullopt_t, const optional<T>& x) noexcept {
|
|
return !x;
|
|
}
|
|
|
|
// Comparison with T [optional.comp_with_t]
|
|
// The C++17 (N4606) "Equivalent to:" statements are used directly here.
|
|
template <class T>
|
|
constexpr bool operator==(const optional<T>& x, const T& v) {
|
|
return static_cast<bool>(x) ? *x == v : false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator==(const T& v, const optional<T>& x) {
|
|
return static_cast<bool>(x) ? v == *x : false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator!=(const optional<T>& x, const T& v) {
|
|
return static_cast<bool>(x) ? *x != v : true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator!=(const T& v, const optional<T>& x) {
|
|
return static_cast<bool>(x) ? v != *x : true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<(const optional<T>& x, const T& v) {
|
|
return static_cast<bool>(x) ? *x < v : true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<(const T& v, const optional<T>& x) {
|
|
return static_cast<bool>(x) ? v < *x : false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<=(const optional<T>& x, const T& v) {
|
|
return static_cast<bool>(x) ? *x <= v : true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator<=(const T& v, const optional<T>& x) {
|
|
return static_cast<bool>(x) ? v <= *x : false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>(const optional<T>& x, const T& v) {
|
|
return static_cast<bool>(x) ? *x > v : false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>(const T& v, const optional<T>& x) {
|
|
return static_cast<bool>(x) ? v > *x : true;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>=(const optional<T>& x, const T& v) {
|
|
return static_cast<bool>(x) ? *x >= v : false;
|
|
}
|
|
template <class T>
|
|
constexpr bool operator>=(const T& v, const optional<T>& x) {
|
|
return static_cast<bool>(x) ? v >= *x : true;
|
|
}
|
|
|
|
} // namespace gtl
|
|
|
|
namespace std {
|
|
|
|
template <class T>
|
|
struct hash<::gtl::optional<T>> {
|
|
size_t operator()(const ::gtl::optional<T>& opt) const {
|
|
if (opt) {
|
|
return hash<T>()(*opt);
|
|
} else {
|
|
return static_cast<size_t>(0x297814aaad196e6dULL);
|
|
}
|
|
}
|
|
};
|
|
|
|
using ::gtl::optional;
|
|
using ::gtl::bad_optional_access;
|
|
using ::gtl::nullopt_t;
|
|
using ::gtl::nullopt;
|
|
using ::gtl::make_optional;
|
|
} // namespace std
|
|
|
|
#endif
|