/* * Copyright (c) 2018-2020, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #define NONNULLREFPTR_SCRUB_BYTE 0xe1 #ifdef KERNEL # include #else # include # include # include # include # include namespace AK { template class OwnPtr; template class RefPtr; template ALWAYS_INLINE void ref_if_not_null(T* ptr) { if (ptr) ptr->ref(); } template ALWAYS_INLINE void unref_if_not_null(T* ptr) { if (ptr) ptr->unref(); } template class [[nodiscard]] NonnullRefPtr { template friend class RefPtr; template friend class NonnullRefPtr; template friend class WeakPtr; public: using ElementType = T; enum AdoptTag { Adopt }; ALWAYS_INLINE NonnullRefPtr(T const& object) : m_ptr(const_cast(&object)) { m_ptr->ref(); } template ALWAYS_INLINE NonnullRefPtr(U const& object) requires(IsConvertible) : m_ptr(const_cast(static_cast(&object))) { m_ptr->ref(); } ALWAYS_INLINE NonnullRefPtr(AdoptTag, T& object) : m_ptr(&object) { } ALWAYS_INLINE NonnullRefPtr(NonnullRefPtr&& other) : m_ptr(&other.leak_ref()) { } template ALWAYS_INLINE NonnullRefPtr(NonnullRefPtr&& other) requires(IsConvertible) : m_ptr(static_cast(&other.leak_ref())) { } ALWAYS_INLINE NonnullRefPtr(NonnullRefPtr const& other) : m_ptr(const_cast(other.ptr())) { m_ptr->ref(); } template ALWAYS_INLINE NonnullRefPtr(NonnullRefPtr const& other) requires(IsConvertible) : m_ptr(const_cast(static_cast(other.ptr()))) { m_ptr->ref(); } ALWAYS_INLINE ~NonnullRefPtr() { unref_if_not_null(m_ptr); m_ptr = nullptr; # ifdef SANITIZE_PTRS m_ptr = reinterpret_cast(explode_byte(NONNULLREFPTR_SCRUB_BYTE)); # endif } template NonnullRefPtr(OwnPtr const&) = delete; template NonnullRefPtr& operator=(OwnPtr const&) = delete; template NonnullRefPtr(RefPtr const&) = delete; template NonnullRefPtr& operator=(RefPtr const&) = delete; NonnullRefPtr(RefPtr const&) = delete; NonnullRefPtr& operator=(RefPtr const&) = delete; NonnullRefPtr& operator=(NonnullRefPtr const& other) { NonnullRefPtr tmp { other }; swap(tmp); return *this; } template NonnullRefPtr& operator=(NonnullRefPtr const& other) requires(IsConvertible) { NonnullRefPtr tmp { other }; swap(tmp); return *this; } ALWAYS_INLINE NonnullRefPtr& operator=(NonnullRefPtr&& other) { NonnullRefPtr tmp { move(other) }; swap(tmp); return *this; } template NonnullRefPtr& operator=(NonnullRefPtr&& other) requires(IsConvertible) { NonnullRefPtr tmp { move(other) }; swap(tmp); return *this; } NonnullRefPtr& operator=(T const& object) { NonnullRefPtr tmp { object }; swap(tmp); return *this; } [[nodiscard]] ALWAYS_INLINE T& leak_ref() { T* ptr = exchange(m_ptr, nullptr); VERIFY(ptr); return *ptr; } ALWAYS_INLINE RETURNS_NONNULL T* ptr() { return as_nonnull_ptr(); } ALWAYS_INLINE RETURNS_NONNULL const T* ptr() const { return as_nonnull_ptr(); } ALWAYS_INLINE RETURNS_NONNULL T* operator->() { return as_nonnull_ptr(); } ALWAYS_INLINE RETURNS_NONNULL const T* operator->() const { return as_nonnull_ptr(); } ALWAYS_INLINE T& operator*() { return *as_nonnull_ptr(); } ALWAYS_INLINE const T& operator*() const { return *as_nonnull_ptr(); } ALWAYS_INLINE RETURNS_NONNULL operator T*() { return as_nonnull_ptr(); } ALWAYS_INLINE RETURNS_NONNULL operator const T*() const { return as_nonnull_ptr(); } ALWAYS_INLINE operator T&() { return *as_nonnull_ptr(); } ALWAYS_INLINE operator const T&() const { return *as_nonnull_ptr(); } operator bool() const = delete; bool operator!() const = delete; void swap(NonnullRefPtr& other) { AK::swap(m_ptr, other.m_ptr); } template void swap(NonnullRefPtr& other) requires(IsConvertible) { AK::swap(m_ptr, other.m_ptr); } bool operator==(NonnullRefPtr const& other) const { return m_ptr == other.m_ptr; } bool operator!=(NonnullRefPtr const& other) const { return m_ptr != other.m_ptr; } bool operator==(NonnullRefPtr& other) { return m_ptr == other.m_ptr; } bool operator!=(NonnullRefPtr& other) { return m_ptr != other.m_ptr; } // clang-format off private: NonnullRefPtr() = delete; // clang-format on ALWAYS_INLINE RETURNS_NONNULL T* as_nonnull_ptr() const { VERIFY(m_ptr); return m_ptr; } T* m_ptr { nullptr }; }; template inline NonnullRefPtr adopt_ref(T& object) { return NonnullRefPtr(NonnullRefPtr::Adopt, object); } template struct Formatter> : Formatter { ErrorOr format(FormatBuilder& builder, NonnullRefPtr const& value) { return Formatter::format(builder, value.ptr()); } }; template inline void swap(NonnullRefPtr& a, NonnullRefPtr& b) requires(IsConvertible) { a.swap(b); } template requires(IsConstructible) inline NonnullRefPtr make_ref_counted(Args&&... args) { return NonnullRefPtr(NonnullRefPtr::Adopt, *new T(forward(args)...)); } // FIXME: Remove once P0960R3 is available in Clang. template inline NonnullRefPtr make_ref_counted(Args&&... args) { return NonnullRefPtr(NonnullRefPtr::Adopt, *new T { forward(args)... }); } } template struct Traits> : public GenericTraits> { using PeekType = T*; using ConstPeekType = const T*; static unsigned hash(NonnullRefPtr const& p) { return ptr_hash(p.ptr()); } static bool equals(NonnullRefPtr const& a, NonnullRefPtr const& b) { return a.ptr() == b.ptr(); } }; using AK::adopt_ref; using AK::make_ref_counted; using AK::NonnullRefPtr; #endif