/* * Copyright (C) 2006, 2007, 2008, 2009, 2010 Apple Inc. All rights reserved. * Copyright (C) 2013 Intel Corporation. All rights reserved. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB. If not, write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. * */ #ifndef WTF_OwnPtr_h #define WTF_OwnPtr_h #include "wtf/Allocator.h" #include "wtf/HashTableDeletedValueType.h" #include "wtf/Noncopyable.h" #include "wtf/OwnPtrCommon.h" #include #include namespace WTF { template class PassOwnPtr; template class OwnPtr { USING_FAST_MALLOC(OwnPtr); WTF_MAKE_NONCOPYABLE(OwnPtr); public: typedef typename std::remove_extent::type ValueType; typedef ValueType* PtrType; OwnPtr() : m_ptr(nullptr) {} OwnPtr(std::nullptr_t) : m_ptr(nullptr) {} // See comment in PassOwnPtr.h for why this takes a const reference. OwnPtr(const PassOwnPtr&); template OwnPtr(const PassOwnPtr&, EnsurePtrConvertibleArgDecl(U, T)); // Hash table deleted values, which are only constructed and never copied or // destroyed. OwnPtr(HashTableDeletedValueType) : m_ptr(hashTableDeletedValue()) {} bool isHashTableDeletedValue() const { return m_ptr == hashTableDeletedValue(); } ~OwnPtr() { OwnedPtrDeleter::deletePtr(m_ptr); m_ptr = nullptr; } PtrType get() const { return m_ptr; } void clear(); PassOwnPtr release(); PtrType leakPtr() WARN_UNUSED_RETURN; ValueType& operator*() const { ASSERT(m_ptr); return *m_ptr; } PtrType operator->() const { ASSERT(m_ptr); return m_ptr; } ValueType& operator[](std::ptrdiff_t i) const; bool operator!() const { return !m_ptr; } // This conversion operator allows implicit conversion to bool but not to // other integer types. typedef PtrType OwnPtr::*UnspecifiedBoolType; operator UnspecifiedBoolType() const { return m_ptr ? &OwnPtr::m_ptr : 0; } OwnPtr& operator=(const PassOwnPtr&); OwnPtr& operator=(std::nullptr_t) { clear(); return *this; } template OwnPtr& operator=(const PassOwnPtr&); OwnPtr(OwnPtr&&); template OwnPtr(OwnPtr&&); OwnPtr& operator=(OwnPtr&&); template OwnPtr& operator=(OwnPtr&&); void swap(OwnPtr& o) { std::swap(m_ptr, o.m_ptr); } static T* hashTableDeletedValue() { return reinterpret_cast(-1); } private: // We should never have two OwnPtrs for the same underlying object // (otherwise we'll get double-destruction), so these equality operators // should never be needed. template bool operator==(const OwnPtr&) const { static_assert(!sizeof(U*), "OwnPtrs should never be equal"); return false; } template bool operator!=(const OwnPtr&) const { static_assert(!sizeof(U*), "OwnPtrs should never be equal"); return false; } template bool operator==(const PassOwnPtr&) const { static_assert(!sizeof(U*), "OwnPtrs should never be equal"); return false; } template bool operator!=(const PassOwnPtr&) const { static_assert(!sizeof(U*), "OwnPtrs should never be equal"); return false; } PtrType m_ptr; }; template inline OwnPtr::OwnPtr(const PassOwnPtr& o) : m_ptr(o.leakPtr()) { } template template inline OwnPtr::OwnPtr(const PassOwnPtr& o, EnsurePtrConvertibleArgDefn(U, T)) : m_ptr(o.leakPtr()) { static_assert(!std::is_array::value, "pointers to array must never be converted"); } template inline void OwnPtr::clear() { PtrType ptr = m_ptr; m_ptr = nullptr; OwnedPtrDeleter::deletePtr(ptr); } template inline PassOwnPtr OwnPtr::release() { PtrType ptr = m_ptr; m_ptr = nullptr; return PassOwnPtr(ptr); } template inline typename OwnPtr::PtrType OwnPtr::leakPtr() { PtrType ptr = m_ptr; m_ptr = nullptr; return ptr; } template inline typename OwnPtr::ValueType& OwnPtr::operator[](std::ptrdiff_t i) const { static_assert(std::is_array::value, "elements access is possible for arrays only"); ASSERT(m_ptr); ASSERT(i >= 0); return m_ptr[i]; } template inline OwnPtr& OwnPtr::operator=(const PassOwnPtr& o) { PtrType ptr = m_ptr; m_ptr = o.leakPtr(); ASSERT(!ptr || m_ptr != ptr); OwnedPtrDeleter::deletePtr(ptr); return *this; } template template inline OwnPtr& OwnPtr::operator=(const PassOwnPtr& o) { static_assert(!std::is_array::value, "pointers to array must never be converted"); PtrType ptr = m_ptr; m_ptr = o.leakPtr(); ASSERT(!ptr || m_ptr != ptr); OwnedPtrDeleter::deletePtr(ptr); return *this; } template inline OwnPtr::OwnPtr(OwnPtr&& o) : m_ptr(o.leakPtr()) { } template template inline OwnPtr::OwnPtr(OwnPtr&& o) : m_ptr(o.leakPtr()) { static_assert(!std::is_array::value, "pointers to array must never be converted"); } template inline OwnPtr& OwnPtr::operator=(OwnPtr&& o) { PtrType ptr = m_ptr; m_ptr = o.leakPtr(); ASSERT(!ptr || m_ptr != ptr); OwnedPtrDeleter::deletePtr(ptr); return *this; } template template inline OwnPtr& OwnPtr::operator=(OwnPtr&& o) { static_assert(!std::is_array::value, "pointers to array must never be converted"); PtrType ptr = m_ptr; m_ptr = o.leakPtr(); ASSERT(!ptr || m_ptr != ptr); OwnedPtrDeleter::deletePtr(ptr); return *this; } template inline void swap(OwnPtr& a, OwnPtr& b) { a.swap(b); } template inline bool operator==(const OwnPtr& a, U* b) { return a.get() == b; } template inline bool operator==(T* a, const OwnPtr& b) { return a == b.get(); } template inline bool operator!=(const OwnPtr& a, U* b) { return a.get() != b; } template inline bool operator!=(T* a, const OwnPtr& b) { return a != b.get(); } template inline typename OwnPtr::PtrType getPtr(const OwnPtr& p) { return p.get(); } } // namespace WTF using WTF::OwnPtr; #endif // WTF_OwnPtr_h