/* * Copyright (C) 2005-2018 Apple Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of Apple Inc. ("Apple") nor the names of * its contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #pragma once #include #include #include #if !defined(WARN_UNUSED_RETURN) #define WARN_UNUSED_RETURN #endif inline void JSRetain(JSStringRef string) { JSStringRetain(string); } inline void JSRelease(JSStringRef string) { JSStringRelease(string); } inline void JSRetain(JSGlobalContextRef context) { JSGlobalContextRetain(context); } inline void JSRelease(JSGlobalContextRef context) { JSGlobalContextRelease(context); } enum AdoptTag { Adopt }; template class JSRetainPtr { public: JSRetainPtr() = default; JSRetainPtr(T ptr) : m_ptr(ptr) { if (ptr) JSRetain(ptr); } JSRetainPtr(const JSRetainPtr&); JSRetainPtr(JSRetainPtr&&); ~JSRetainPtr(); T get() const { return m_ptr; } void clear(); T leakRef() WARN_UNUSED_RETURN; T operator->() const { return m_ptr; } bool operator!() const { return !m_ptr; } explicit operator bool() const { return m_ptr; } JSRetainPtr& operator=(const JSRetainPtr&); JSRetainPtr& operator=(JSRetainPtr&&); JSRetainPtr& operator=(T); void swap(JSRetainPtr&); friend JSRetainPtr adopt(JSStringRef); friend JSRetainPtr adopt(JSGlobalContextRef); // FIXME: Make this private once Apple's internal code is updated to not rely on it. // https://bugs.webkit.org/show_bug.cgi?id=189644 JSRetainPtr(AdoptTag, T); private: T m_ptr { nullptr }; }; JSRetainPtr adopt(JSStringRef); JSRetainPtr adopt(JSGlobalContextRef); template inline JSRetainPtr::JSRetainPtr(AdoptTag, T ptr) : m_ptr(ptr) { } inline JSRetainPtr adopt(JSStringRef o) { return JSRetainPtr(Adopt, o); } inline JSRetainPtr adopt(JSGlobalContextRef o) { return JSRetainPtr(Adopt, o); } template inline JSRetainPtr::JSRetainPtr(const JSRetainPtr& o) : m_ptr(o.m_ptr) { if (m_ptr) JSRetain(m_ptr); } template inline JSRetainPtr::JSRetainPtr(JSRetainPtr&& o) : m_ptr(o.leakRef()) { } template inline JSRetainPtr::~JSRetainPtr() { if (m_ptr) JSRelease(m_ptr); } template inline void JSRetainPtr::clear() { if (T ptr = leakRef()) JSRelease(ptr); } template inline T JSRetainPtr::leakRef() { return std::exchange(m_ptr, nullptr); } template inline JSRetainPtr& JSRetainPtr::operator=(const JSRetainPtr& o) { return operator=(o.get()); } template inline JSRetainPtr& JSRetainPtr::operator=(JSRetainPtr&& o) { if (T ptr = std::exchange(m_ptr, o.leakRef())) JSRelease(ptr); return *this; } template inline JSRetainPtr& JSRetainPtr::operator=(T optr) { if (optr) JSRetain(optr); if (T ptr = std::exchange(m_ptr, optr)) JSRelease(ptr); return *this; } template inline void JSRetainPtr::swap(JSRetainPtr& o) { std::swap(m_ptr, o.m_ptr); } template inline void swap(JSRetainPtr& a, JSRetainPtr& b) { a.swap(b); } template inline bool operator==(const JSRetainPtr& a, const JSRetainPtr& b) { return a.get() == b.get(); } template inline bool operator==(const JSRetainPtr& a, U* b) { return a.get() == b; } template inline bool operator==(T* a, const JSRetainPtr& b) { return a == b.get(); } template inline bool operator!=(const JSRetainPtr& a, const JSRetainPtr& b) { return a.get() != b.get(); } template inline bool operator!=(const JSRetainPtr& a, U* b) { return a.get() != b; } template inline bool operator!=(T* a, const JSRetainPtr& b) { return a != b.get(); }