//===- llvm/Support/ErrorOr.h - Error Smart Pointer -----------------------===// // // The LLVM Linker // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// /// /// \file /// /// Provides ErrorOr smart pointer. /// //===----------------------------------------------------------------------===// #ifndef LLVM_SUPPORT_ERROROR_H #define LLVM_SUPPORT_ERROROR_H #include "llvm/ADT/PointerIntPair.h" #include "llvm/Support/AlignOf.h" #include #include #include namespace llvm { template typename std::enable_if< std::is_constructible::value , typename std::remove_reference::type>::type && moveIfMoveConstructible(V &Val) { return std::move(Val); } template typename std::enable_if< !std::is_constructible::value , typename std::remove_reference::type>::type & moveIfMoveConstructible(V &Val) { return Val; } /// \brief Stores a reference that can be changed. template class ReferenceStorage { T *Storage; public: ReferenceStorage(T &Ref) : Storage(&Ref) {} operator T &() const { return *Storage; } T &get() const { return *Storage; } }; /// \brief Represents either an error or a value T. /// /// ErrorOr is a pointer-like class that represents the result of an /// operation. The result is either an error, or a value of type T. This is /// designed to emulate the usage of returning a pointer where nullptr indicates /// failure. However instead of just knowing that the operation failed, we also /// have an error_code and optional user data that describes why it failed. /// /// It is used like the following. /// \code /// ErrorOr getBuffer(); /// /// auto buffer = getBuffer(); /// if (error_code ec = buffer.getError()) /// return ec; /// buffer->write("adena"); /// \endcode /// /// /// An implicit conversion to bool provides a way to check if there was an /// error. The unary * and -> operators provide pointer like access to the /// value. Accessing the value when there is an error has undefined behavior. /// /// When T is a reference type the behaivor is slightly different. The reference /// is held in a std::reference_wrapper::type>, and /// there is special handling to make operator -> work as if T was not a /// reference. /// /// T cannot be a rvalue reference. template class ErrorOr { template friend class ErrorOr; static const bool isRef = std::is_reference::value; typedef ReferenceStorage::type> wrap; public: typedef typename std::conditional::type storage_type; private: typedef typename std::remove_reference::type &reference; typedef const typename std::remove_reference::type &const_reference; typedef typename std::remove_reference::type *pointer; public: template ErrorOr(E ErrorCode, typename std::enable_if::value || std::is_error_condition_enum::value, void *>::type = 0) : HasError(true) { new (getErrorStorage()) std::error_code(make_error_code(ErrorCode)); } ErrorOr(std::error_code EC) : HasError(true) { new (getErrorStorage()) std::error_code(EC); } ErrorOr(T Val) : HasError(false) { new (getStorage()) storage_type(moveIfMoveConstructible(Val)); } ErrorOr(const ErrorOr &Other) { copyConstruct(Other); } template ErrorOr(const ErrorOr &Other) { copyConstruct(Other); } ErrorOr &operator =(const ErrorOr &Other) { copyAssign(Other); return *this; } template ErrorOr &operator =(const ErrorOr &Other) { copyAssign(Other); return *this; } ErrorOr(ErrorOr &&Other) { moveConstruct(std::move(Other)); } template ErrorOr(ErrorOr &&Other) { moveConstruct(std::move(Other)); } ErrorOr &operator =(ErrorOr &&Other) { moveAssign(std::move(Other)); return *this; } template ErrorOr &operator =(ErrorOr &&Other) { moveAssign(std::move(Other)); return *this; } ~ErrorOr() { if (!HasError) getStorage()->~storage_type(); } /// \brief Return false if there is an error. LLVM_EXPLICIT operator bool() const { return !HasError; } reference get() { return *getStorage(); } const_reference get() const { return const_cast >(this)->get(); } std::error_code getError() const { return HasError ? *getErrorStorage() : std::error_code(); } pointer operator ->() { return toPointer(getStorage()); } reference operator *() { return *getStorage(); } private: template void copyConstruct(const ErrorOr &Other) { if (!Other.HasError) { // Get the other value. HasError = false; new (getStorage()) storage_type(*Other.getStorage()); } else { // Get other's error. HasError = true; new (getErrorStorage()) std::error_code(Other.getError()); } } template static bool compareThisIfSameType(const T1 &a, const T1 &b) { return &a == &b; } template static bool compareThisIfSameType(const T1 &a, const T2 &b) { return false; } template void copyAssign(const ErrorOr &Other) { if (compareThisIfSameType(*this, Other)) return; this->~ErrorOr(); new (this) ErrorOr(Other); } template void moveConstruct(ErrorOr &&Other) { if (!Other.HasError) { // Get the other value. HasError = false; new (getStorage()) storage_type(std::move(*Other.getStorage())); } else { // Get other's error. HasError = true; new (getErrorStorage()) std::error_code(Other.getError()); } } template void moveAssign(ErrorOr &&Other) { if (compareThisIfSameType(*this, Other)) return; this->~ErrorOr(); new (this) ErrorOr(std::move(Other)); } pointer toPointer(pointer Val) { return Val; } pointer toPointer(wrap *Val) { return &Val->get(); } storage_type *getStorage() { assert(!HasError && "Cannot get value when an error exists!"); return reinterpret_cast(TStorage.buffer); } const storage_type *getStorage() const { assert(!HasError && "Cannot get value when an error exists!"); return reinterpret_cast(TStorage.buffer); } std::error_code *getErrorStorage() { assert(HasError && "Cannot get error when a value exists!"); return reinterpret_cast(ErrorStorage.buffer); } const std::error_code *getErrorStorage() const { return const_cast *>(this)->getErrorStorage(); } union { AlignedCharArrayUnion TStorage; AlignedCharArrayUnion ErrorStorage; }; bool HasError : 1; }; template typename std::enable_if::value || std::is_error_condition_enum::value, bool>::type operator==(ErrorOr &Err, E Code) { return std::error_code(Err) == Code; } } // end namespace llvm #endif