// Copyright 2011 the V8 project authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #ifndef V8_BASE_SMART_POINTERS_H_ #define V8_BASE_SMART_POINTERS_H_ #include "src/base/logging.h" namespace v8 { namespace base { template class SmartPointerBase { public: // Default constructor. Constructs an empty scoped pointer. SmartPointerBase() : p_(NULL) {} // Constructs a scoped pointer from a plain one. explicit SmartPointerBase(T* ptr) : p_(ptr) {} // Copy constructor removes the pointer from the original to avoid double // freeing. SmartPointerBase(const SmartPointerBase& rhs) : p_(rhs.p_) { const_cast&>(rhs).p_ = NULL; } T* operator->() const { return p_; } T& operator*() const { return *p_; } T* get() const { return p_; } // You can use [n] to index as if it was a plain pointer. T& operator[](size_t i) { return p_[i]; } // You can use [n] to index as if it was a plain pointer. const T& operator[](size_t i) const { return p_[i]; } // We don't have implicit conversion to a T* since that hinders migration: // You would not be able to change a method from returning a T* to // returning an SmartArrayPointer and then get errors wherever it is used. // If you want to take out the plain pointer and don't want it automatically // deleted then call Detach(). Afterwards, the smart pointer is empty // (NULL). T* Detach() { T* temp = p_; p_ = NULL; return temp; } void Reset(T* new_value) { DCHECK(p_ == NULL || p_ != new_value); if (p_) Deallocator::Delete(p_); p_ = new_value; } // Assignment requires an empty (NULL) SmartArrayPointer as the receiver. Like // the copy constructor it removes the pointer in the original to avoid // double freeing. SmartPointerBase& operator=( const SmartPointerBase& rhs) { DCHECK(is_empty()); T* tmp = rhs.p_; // swap to handle self-assignment const_cast&>(rhs).p_ = NULL; p_ = tmp; return *this; } bool is_empty() const { return p_ == NULL; } protected: // When the destructor of the scoped pointer is executed the plain pointer // is deleted using DeleteArray. This implies that you must allocate with // NewArray. ~SmartPointerBase() { if (p_) Deallocator::Delete(p_); } private: T* p_; }; // A 'scoped array pointer' that calls DeleteArray on its pointer when the // destructor is called. template struct ArrayDeallocator { static void Delete(T* array) { delete[] array; } }; template class SmartArrayPointer : public SmartPointerBase, T> { public: SmartArrayPointer() {} explicit SmartArrayPointer(T* ptr) : SmartPointerBase, T>(ptr) {} SmartArrayPointer(const SmartArrayPointer& rhs) : SmartPointerBase, T>(rhs) {} }; template struct ObjectDeallocator { static void Delete(T* object) { delete object; } }; template class SmartPointer : public SmartPointerBase, T> { public: SmartPointer() {} explicit SmartPointer(T* ptr) : SmartPointerBase, T>(ptr) {} SmartPointer(const SmartPointer& rhs) : SmartPointerBase, T>(rhs) {} }; } // namespace base } // namespace v8 #endif // V8_SMART_POINTERS_H_