/////////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2015 Microsoft Corporation. All rights reserved. // // This code is licensed under the MIT License (MIT). // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. // /////////////////////////////////////////////////////////////////////////////// #pragma once #ifndef GSL_GSL_H #define GSL_GSL_H #include // Ensures/Expects #include // finally()/narrow()/narrow_cast()... #include // multi_span, strided_span... #include // span #include // zstring, string_span, zstring_builder... #include #include #if defined(_MSC_VER) && _MSC_VER < 1910 #pragma push_macro("constexpr") #define constexpr /*constexpr*/ // MSVC 2013 workarounds #if _MSC_VER <= 1800 // noexcept is not understood #pragma push_macro("noexcept") #define noexcept /*noexcept*/ // turn off some misguided warnings #pragma warning(push) #pragma warning(disable : 4351) // warns about newly introduced aggregate initializer behavior #endif // _MSC_VER <= 1800 #endif // defined(_MSC_VER) && _MSC_VER < 1910 namespace gsl { // // GSL.owner: ownership pointers // using std::unique_ptr; using std::shared_ptr; template using owner = T; // // not_null // // Restricts a pointer or smart pointer to only hold non-null values. // // Has zero size overhead over T. // // If T is a pointer (i.e. T == U*) then // - allow construction from U* // - disallow construction from nullptr_t // - disallow default construction // - ensure construction from null U* fails // - allow implicit conversion to U* // template class not_null { public: static_assert(std::is_assignable::value, "T cannot be assigned nullptr."); template ::value>> constexpr not_null(U&& u) : ptr_(std::forward(u)) { Expects(ptr_ != nullptr); } template ::value>> constexpr not_null(const not_null& other) : not_null(other.get()) { } not_null(const not_null& other) = default; not_null& operator=(const not_null& other) = default; constexpr T get() const { Ensures(ptr_ != nullptr); return ptr_; } constexpr operator T() const { return get(); } constexpr T operator->() const { return get(); } // prevents compilation when someone attempts to assign a null pointer constant not_null(std::nullptr_t) = delete; not_null& operator=(std::nullptr_t) = delete; // unwanted operators...pointers only point to single objects! not_null& operator++() = delete; not_null& operator--() = delete; not_null operator++(int) = delete; not_null operator--(int) = delete; not_null& operator+=(std::ptrdiff_t) = delete; not_null& operator-=(std::ptrdiff_t) = delete; void operator[](std::ptrdiff_t) const = delete; private: T ptr_; }; template std::ostream& operator<<(std::ostream& os, const not_null& val) { os << val.get(); return os; } template auto operator==(const not_null& lhs, const not_null& rhs) -> decltype(lhs.get() == rhs.get()) { return lhs.get() == rhs.get(); } template auto operator!=(const not_null& lhs, const not_null& rhs) -> decltype(lhs.get() != rhs.get()) { return lhs.get() != rhs.get(); } template auto operator<(const not_null& lhs, const not_null& rhs) -> decltype(lhs.get() < rhs.get()) { return lhs.get() < rhs.get(); } template auto operator<=(const not_null& lhs, const not_null& rhs) -> decltype(lhs.get() <= rhs.get()) { return lhs.get() <= rhs.get(); } template auto operator>(const not_null& lhs, const not_null& rhs) -> decltype(lhs.get() > rhs.get()) { return lhs.get() > rhs.get(); } template auto operator>=(const not_null& lhs, const not_null& rhs) -> decltype(lhs.get() >= rhs.get()) { return lhs.get() >= rhs.get(); } // more unwanted operators template std::ptrdiff_t operator-(const not_null&, const not_null&) = delete; template not_null operator-(const not_null&, std::ptrdiff_t) = delete; template not_null operator+(const not_null&, std::ptrdiff_t) = delete; template not_null operator+(std::ptrdiff_t, const not_null&) = delete; } // namespace gsl namespace std { template struct hash> { std::size_t operator()(const gsl::not_null& value) const { return hash{}(value); } }; } // namespace std #if defined(_MSC_VER) && _MSC_VER < 1910 #undef constexpr #pragma pop_macro("constexpr") #if _MSC_VER <= 1800 #undef noexcept #pragma pop_macro("noexcept") #pragma warning(pop) #endif // _MSC_VER <= 1800 #endif // defined(_MSC_VER) && _MSC_VER < 1910 #endif // GSL_GSL_H