/* * 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() { VERIFY(m_ptr); return m_ptr; } ALWAYS_INLINE RETURNS_NONNULL const T* ptr() const { VERIFY(m_ptr); return m_ptr; } ALWAYS_INLINE RETURNS_NONNULL T* operator->() { return ptr(); } ALWAYS_INLINE RETURNS_NONNULL const T* operator->() const { return ptr(); } ALWAYS_INLINE T& operator*() { return *ptr(); } ALWAYS_INLINE const T& operator*() const { return *ptr(); } ALWAYS_INLINE RETURNS_NONNULL operator const T*() const { return ptr(); } ALWAYS_INLINE RETURNS_NONNULL operator T*() { return ptr(); } operator bool() const = delete; bool operator!() const = delete; void swap(NonnullOwnPtr& other) { ::swap(m_ptr, other.m_ptr); } template void swap(NonnullOwnPtr& other) { ::swap(m_ptr, other.m_ptr); } template NonnullOwnPtr release_nonnull() { VERIFY(m_ptr); return NonnullOwnPtr(NonnullOwnPtr::Adopt, static_cast(*leak_ptr())); } private: void clear() { if (!m_ptr) return; delete m_ptr; m_ptr = nullptr; } 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)...)); } // FIXME: Remove once P0960R3 is available in Clang. template inline NonnullOwnPtr make(Args&&... args) { return NonnullOwnPtr(NonnullOwnPtr::Adopt, *new T { forward(args)... }); } #endif template struct Traits> : public GenericTraits> { using PeekType = T*; using ConstPeekType = const T*; static unsigned hash(NonnullOwnPtr const& p) { return ptr_hash((FlatPtr)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.ptr()); } }; } #if !defined(KERNEL) using AK::adopt_own; using AK::make; #endif using AK::NonnullOwnPtr;