/* * Copyright (c) 2018-2020, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #define NONNULLOWNPTR_SCRUB_BYTE 0xf1 namespace AK { template class WeakPtr; template class [[nodiscard]] NonnullOwnPtr { public: using ElementType = T; enum AdoptTag { Adopt }; NonnullOwnPtr(AdoptTag, T& ptr) : m_ptr(&ptr) { static_assert( requires { requires typename T::AllowOwnPtr()(); } || !requires { requires !typename T::AllowOwnPtr()(); declval().ref(); declval().unref(); }, "Use NonnullRefPtr<> for RefCounted types"); } NonnullOwnPtr(NonnullOwnPtr&& other) : m_ptr(other.leak_ptr()) { VERIFY(m_ptr); } template NonnullOwnPtr(NonnullOwnPtr&& other) : m_ptr(other.leak_ptr()) { VERIFY(m_ptr); } ~NonnullOwnPtr() { clear(); #ifdef SANITIZE_PTRS m_ptr = (T*)(explode_byte(NONNULLOWNPTR_SCRUB_BYTE)); #endif } NonnullOwnPtr(NonnullOwnPtr const&) = delete; template NonnullOwnPtr(NonnullOwnPtr const&) = delete; NonnullOwnPtr& operator=(NonnullOwnPtr const&) = delete; template NonnullOwnPtr& operator=(NonnullOwnPtr const&) = delete; template NonnullOwnPtr(RefPtr const&) = delete; template NonnullOwnPtr(NonnullRefPtr const&) = delete; template NonnullOwnPtr(WeakPtr const&) = delete; template NonnullOwnPtr& operator=(RefPtr const&) = delete; template NonnullOwnPtr& operator=(NonnullRefPtr const&) = delete; template NonnullOwnPtr& operator=(WeakPtr const&) = delete; NonnullOwnPtr& operator=(NonnullOwnPtr&& other) { NonnullOwnPtr ptr(move(other)); swap(ptr); return *this; } template NonnullOwnPtr& operator=(NonnullOwnPtr&& other) { NonnullOwnPtr ptr(move(other)); swap(ptr); return *this; } [[nodiscard]] T* leak_ptr() { return exchange(m_ptr, nullptr); } ALWAYS_INLINE RETURNS_NONNULL T* ptr() const { VERIFY(m_ptr); return m_ptr; } ALWAYS_INLINE RETURNS_NONNULL T* operator->() const { return ptr(); } ALWAYS_INLINE T& operator*() const { return *ptr(); } ALWAYS_INLINE RETURNS_NONNULL operator T*() const { return ptr(); } operator bool() const = delete; bool operator!() const = delete; void swap(NonnullOwnPtr& other) { AK::swap(m_ptr, other.m_ptr); } template void swap(NonnullOwnPtr& other) { AK::swap(m_ptr, other.m_ptr); } template NonnullOwnPtr release_nonnull() { VERIFY(m_ptr); return NonnullOwnPtr(NonnullOwnPtr::Adopt, static_cast(*leak_ptr())); } private: void clear() { auto* ptr = exchange(m_ptr, nullptr); delete ptr; } T* m_ptr = nullptr; }; #if !defined(KERNEL) template inline NonnullOwnPtr adopt_own(T& object) { return NonnullOwnPtr(NonnullOwnPtr::Adopt, object); } template requires(IsConstructible) inline NonnullOwnPtr make(Args&&... args) { return NonnullOwnPtr(NonnullOwnPtr::Adopt, *new T(forward(args)...)); } # ifdef AK_COMPILER_APPLE_CLANG // FIXME: Remove once P0960R3 is available in Apple Clang. template inline NonnullOwnPtr make(Args&&... args) { return NonnullOwnPtr(NonnullOwnPtr::Adopt, *new T { forward(args)... }); } # endif #endif // Use like `adopt_nonnull_own_or_enomem(new (nothrow) T(args...))`. template inline ErrorOr> adopt_nonnull_own_or_enomem(T* object) { if (!object) return Error::from_errno(ENOMEM); return NonnullOwnPtr(NonnullOwnPtr::Adopt, *object); } template requires(IsConstructible) inline ErrorOr> try_make(Args&&... args) { return adopt_nonnull_own_or_enomem(new (nothrow) T(forward(args)...)); } #ifdef AK_COMPILER_APPLE_CLANG // FIXME: Remove once P0960R3 is available in Apple Clang. template inline ErrorOr> try_make(Args&&... args) { return adopt_nonnull_own_or_enomem(new (nothrow) T { forward(args)... }); } #endif template struct Traits> : public DefaultTraits> { using PeekType = T*; using ConstPeekType = T const*; static unsigned hash(NonnullOwnPtr const& p) { return ptr_hash(p.ptr()); } static bool equals(NonnullOwnPtr const& a, NonnullOwnPtr const& b) { return a.ptr() == b.ptr(); } }; template inline void swap(NonnullOwnPtr& a, NonnullOwnPtr& b) { a.swap(b); } template struct Formatter> : Formatter { ErrorOr format(FormatBuilder& builder, NonnullOwnPtr const& value) { return Formatter::format(builder, *value); } }; template requires(!HasFormatter) struct Formatter> : Formatter { ErrorOr format(FormatBuilder& builder, NonnullOwnPtr const& value) { return Formatter::format(builder, value.ptr()); } }; } #if USING_AK_GLOBALLY # if !defined(KERNEL) using AK::adopt_own; using AK::make; # endif using AK::adopt_nonnull_own_or_enomem; using AK::NonnullOwnPtr; using AK::try_make; #endif