2011-07-28 14:26:00 +00:00
|
|
|
|
2008-12-17 15:59:43 +00:00
|
|
|
/*
|
2011-07-28 14:26:00 +00:00
|
|
|
* Copyright 2006 The Android Open Source Project
|
2008-12-17 15:59:43 +00:00
|
|
|
*
|
2011-07-28 14:26:00 +00:00
|
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
|
|
* found in the LICENSE file.
|
2008-12-17 15:59:43 +00:00
|
|
|
*/
|
|
|
|
|
2011-07-28 14:26:00 +00:00
|
|
|
|
2008-12-17 15:59:43 +00:00
|
|
|
#ifndef SkRefCnt_DEFINED
|
|
|
|
#define SkRefCnt_DEFINED
|
|
|
|
|
|
|
|
#include "SkThread.h"
|
2012-06-05 19:35:09 +00:00
|
|
|
#include "SkInstCnt.h"
|
2012-07-30 15:03:59 +00:00
|
|
|
#include "SkTemplates.h"
|
2008-12-17 15:59:43 +00:00
|
|
|
|
|
|
|
/** \class SkRefCnt
|
|
|
|
|
|
|
|
SkRefCnt is the base class for objects that may be shared by multiple
|
2012-05-16 18:21:56 +00:00
|
|
|
objects. When an existing owner wants to share a reference, it calls ref().
|
|
|
|
When an owner wants to release its reference, it calls unref(). When the
|
|
|
|
shared object's reference count goes to zero as the result of an unref()
|
|
|
|
call, its (virtual) destructor is called. It is an error for the
|
|
|
|
destructor to be called explicitly (or via the object going out of scope on
|
|
|
|
the stack or calling delete) if getRefCnt() > 1.
|
2008-12-17 15:59:43 +00:00
|
|
|
*/
|
2011-03-15 21:27:08 +00:00
|
|
|
class SK_API SkRefCnt : SkNoncopyable {
|
2008-12-17 15:59:43 +00:00
|
|
|
public:
|
2012-06-13 18:54:08 +00:00
|
|
|
SK_DECLARE_INST_COUNT_ROOT(SkRefCnt)
|
2012-06-05 19:35:09 +00:00
|
|
|
|
2008-12-17 15:59:43 +00:00
|
|
|
/** Default construct, initializing the reference count to 1.
|
|
|
|
*/
|
|
|
|
SkRefCnt() : fRefCnt(1) {}
|
|
|
|
|
2012-05-16 18:21:56 +00:00
|
|
|
/** Destruct, asserting that the reference count is 1.
|
2008-12-17 15:59:43 +00:00
|
|
|
*/
|
2011-09-12 19:54:12 +00:00
|
|
|
virtual ~SkRefCnt() {
|
|
|
|
#ifdef SK_DEBUG
|
|
|
|
SkASSERT(fRefCnt == 1);
|
|
|
|
fRefCnt = 0; // illegal value, to catch us if we reuse after delete
|
|
|
|
#endif
|
|
|
|
}
|
2008-12-17 15:59:43 +00:00
|
|
|
|
2013-07-19 23:18:52 +00:00
|
|
|
/** Return the reference count. Use only for debugging. */
|
2008-12-17 15:59:43 +00:00
|
|
|
int32_t getRefCnt() const { return fRefCnt; }
|
|
|
|
|
2013-07-19 23:18:52 +00:00
|
|
|
/** Returns true if the caller is the only owner.
|
|
|
|
* Ensures that all previous owner's actions are complete.
|
|
|
|
*/
|
|
|
|
bool unique() const {
|
|
|
|
bool const unique = (1 == fRefCnt);
|
|
|
|
if (unique) {
|
|
|
|
// Aquire barrier (L/SL), if not provided by load of fRefCnt.
|
|
|
|
// Prevents user's 'unique' code from happening before decrements.
|
|
|
|
//TODO: issue the barrier.
|
|
|
|
}
|
|
|
|
return unique;
|
|
|
|
}
|
|
|
|
|
2008-12-17 15:59:43 +00:00
|
|
|
/** Increment the reference count. Must be balanced by a call to unref().
|
|
|
|
*/
|
|
|
|
void ref() const {
|
|
|
|
SkASSERT(fRefCnt > 0);
|
2012-05-16 18:21:56 +00:00
|
|
|
sk_atomic_inc(&fRefCnt); // No barrier required.
|
2008-12-17 15:59:43 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/** Decrement the reference count. If the reference count is 1 before the
|
2012-05-16 18:21:56 +00:00
|
|
|
decrement, then delete the object. Note that if this is the case, then
|
|
|
|
the object needs to have been allocated via new, and not on the stack.
|
2008-12-17 15:59:43 +00:00
|
|
|
*/
|
|
|
|
void unref() const {
|
|
|
|
SkASSERT(fRefCnt > 0);
|
2012-05-16 18:21:56 +00:00
|
|
|
// Release barrier (SL/S), if not provided below.
|
2008-12-17 15:59:43 +00:00
|
|
|
if (sk_atomic_dec(&fRefCnt) == 1) {
|
2012-05-16 18:21:56 +00:00
|
|
|
// Aquire barrier (L/SL), if not provided above.
|
|
|
|
// Prevents code in dispose from happening before the decrement.
|
|
|
|
sk_membar_aquire__after_atomic_dec();
|
|
|
|
internal_dispose();
|
2008-12-17 15:59:43 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-07-15 15:25:22 +00:00
|
|
|
void validate() const {
|
|
|
|
SkASSERT(fRefCnt > 0);
|
|
|
|
}
|
|
|
|
|
2013-06-26 22:20:22 +00:00
|
|
|
/**
|
|
|
|
* Alias for unref(), for compatibility with WTF::RefPtr.
|
|
|
|
*/
|
|
|
|
void deref() { this->unref(); }
|
|
|
|
|
2012-07-23 14:50:38 +00:00
|
|
|
protected:
|
|
|
|
/**
|
|
|
|
* Allow subclasses to call this if they've overridden internal_dispose
|
|
|
|
* so they can reset fRefCnt before the destructor is called. Should only
|
|
|
|
* be called right before calling through to inherited internal_dispose()
|
|
|
|
* or before calling the destructor.
|
|
|
|
*/
|
|
|
|
void internal_dispose_restore_refcnt_to_1() const {
|
2012-05-16 18:21:56 +00:00
|
|
|
#ifdef SK_DEBUG
|
2012-07-23 14:50:38 +00:00
|
|
|
SkASSERT(0 == fRefCnt);
|
2012-05-16 18:21:56 +00:00
|
|
|
fRefCnt = 1;
|
|
|
|
#endif
|
2012-07-23 14:50:38 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
/**
|
|
|
|
* Called when the ref count goes to 0.
|
|
|
|
*/
|
|
|
|
virtual void internal_dispose() const {
|
|
|
|
this->internal_dispose_restore_refcnt_to_1();
|
2012-05-16 18:21:56 +00:00
|
|
|
SkDELETE(this);
|
|
|
|
}
|
2012-06-22 12:41:43 +00:00
|
|
|
|
2013-07-19 23:18:52 +00:00
|
|
|
// The following friends are those which override internal_dispose()
|
|
|
|
// and conditionally call SkRefCnt::internal_dispose().
|
|
|
|
friend class GrTexture;
|
2012-05-16 18:21:56 +00:00
|
|
|
friend class SkWeakRefCnt;
|
|
|
|
|
2008-12-17 15:59:43 +00:00
|
|
|
mutable int32_t fRefCnt;
|
2012-06-13 18:54:08 +00:00
|
|
|
|
|
|
|
typedef SkNoncopyable INHERITED;
|
2008-12-17 15:59:43 +00:00
|
|
|
};
|
|
|
|
|
2011-07-15 15:25:22 +00:00
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
/** Helper macro to safely assign one SkRefCnt[TS]* to another, checking for
|
|
|
|
null in on each side of the assignment, and ensuring that ref() is called
|
|
|
|
before unref(), in case the two pointers point to the same object.
|
|
|
|
*/
|
|
|
|
#define SkRefCnt_SafeAssign(dst, src) \
|
|
|
|
do { \
|
|
|
|
if (src) src->ref(); \
|
|
|
|
if (dst) dst->unref(); \
|
|
|
|
dst = src; \
|
|
|
|
} while (0)
|
|
|
|
|
|
|
|
|
2012-08-22 18:56:56 +00:00
|
|
|
/** Call obj->ref() and return obj. The obj must not be NULL.
|
2011-07-15 15:25:22 +00:00
|
|
|
*/
|
2012-08-22 18:56:56 +00:00
|
|
|
template <typename T> static inline T* SkRef(T* obj) {
|
|
|
|
SkASSERT(obj);
|
|
|
|
obj->ref();
|
|
|
|
return obj;
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Check if the argument is non-null, and if so, call obj->ref() and return obj.
|
|
|
|
*/
|
|
|
|
template <typename T> static inline T* SkSafeRef(T* obj) {
|
2011-07-15 15:25:22 +00:00
|
|
|
if (obj) {
|
|
|
|
obj->ref();
|
|
|
|
}
|
2012-08-22 18:56:56 +00:00
|
|
|
return obj;
|
2011-07-15 15:25:22 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/** Check if the argument is non-null, and if so, call obj->unref()
|
|
|
|
*/
|
|
|
|
template <typename T> static inline void SkSafeUnref(T* obj) {
|
|
|
|
if (obj) {
|
|
|
|
obj->unref();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2013-09-09 13:38:37 +00:00
|
|
|
template<typename T> static inline void SkSafeSetNull(T*& obj) {
|
|
|
|
if (NULL != obj) {
|
|
|
|
obj->unref();
|
|
|
|
obj = NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-07-15 15:25:22 +00:00
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
2011-02-25 18:10:29 +00:00
|
|
|
/**
|
2012-07-30 15:03:59 +00:00
|
|
|
* Utility class that simply unref's its argument in the destructor.
|
2011-02-25 18:10:29 +00:00
|
|
|
*/
|
2012-07-30 15:03:59 +00:00
|
|
|
template <typename T> class SkAutoTUnref : SkNoncopyable {
|
2008-12-17 15:59:43 +00:00
|
|
|
public:
|
2012-07-30 15:03:59 +00:00
|
|
|
explicit SkAutoTUnref(T* obj = NULL) : fObj(obj) {}
|
|
|
|
~SkAutoTUnref() { SkSafeUnref(fObj); }
|
2011-02-25 18:10:29 +00:00
|
|
|
|
|
|
|
T* get() const { return fObj; }
|
|
|
|
|
2013-03-13 21:28:44 +00:00
|
|
|
T* reset(T* obj) {
|
2012-11-27 18:37:52 +00:00
|
|
|
SkSafeUnref(fObj);
|
|
|
|
fObj = obj;
|
2013-03-13 21:28:44 +00:00
|
|
|
return obj;
|
2011-08-09 15:30:41 +00:00
|
|
|
}
|
|
|
|
|
2012-10-03 13:46:20 +00:00
|
|
|
void swap(SkAutoTUnref* other) {
|
|
|
|
T* tmp = fObj;
|
|
|
|
fObj = other->fObj;
|
|
|
|
other->fObj = tmp;
|
|
|
|
}
|
|
|
|
|
2011-02-25 18:10:29 +00:00
|
|
|
/**
|
|
|
|
* Return the hosted object (which may be null), transferring ownership.
|
|
|
|
* The reference count is not modified, and the internal ptr is set to NULL
|
|
|
|
* so unref() will not be called in our destructor. A subsequent call to
|
|
|
|
* detach() will do nothing and return null.
|
|
|
|
*/
|
|
|
|
T* detach() {
|
|
|
|
T* obj = fObj;
|
|
|
|
fObj = NULL;
|
|
|
|
return obj;
|
|
|
|
}
|
2008-12-17 15:59:43 +00:00
|
|
|
|
2012-06-01 19:38:19 +00:00
|
|
|
/**
|
2013-04-16 15:24:31 +00:00
|
|
|
* BlockRef<B> is a type which inherits from B, cannot be created,
|
|
|
|
* cannot be deleted, and makes ref and unref private.
|
2012-06-01 19:38:19 +00:00
|
|
|
*/
|
2012-06-01 19:47:51 +00:00
|
|
|
template<typename B> class BlockRef : public B {
|
2012-06-01 19:38:19 +00:00
|
|
|
private:
|
|
|
|
BlockRef();
|
2013-04-16 15:24:31 +00:00
|
|
|
~BlockRef();
|
2012-06-01 19:38:19 +00:00
|
|
|
void ref() const;
|
|
|
|
void unref() const;
|
|
|
|
};
|
2012-07-27 13:27:35 +00:00
|
|
|
|
2012-07-30 15:03:59 +00:00
|
|
|
/** If T is const, the type returned from operator-> will also be const. */
|
|
|
|
typedef typename SkTConstType<BlockRef<T>, SkTIsConst<T>::value>::type BlockRefType;
|
2012-07-27 13:27:35 +00:00
|
|
|
|
2012-06-01 19:38:19 +00:00
|
|
|
/**
|
|
|
|
* SkAutoTUnref assumes ownership of the ref. As a result, it is an error
|
|
|
|
* for the user to ref or unref through SkAutoTUnref. Therefore
|
|
|
|
* SkAutoTUnref::operator-> returns BlockRef<T>*. This prevents use of
|
|
|
|
* skAutoTUnrefInstance->ref() and skAutoTUnrefInstance->unref().
|
|
|
|
*/
|
2012-07-30 15:03:59 +00:00
|
|
|
BlockRefType *operator->() const {
|
|
|
|
return static_cast<BlockRefType*>(fObj);
|
2012-06-01 19:38:19 +00:00
|
|
|
}
|
2012-07-30 15:03:59 +00:00
|
|
|
operator T*() { return fObj; }
|
2012-07-27 13:27:35 +00:00
|
|
|
|
2012-07-30 15:03:59 +00:00
|
|
|
private:
|
|
|
|
T* fObj;
|
2011-02-25 18:10:29 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
class SkAutoUnref : public SkAutoTUnref<SkRefCnt> {
|
|
|
|
public:
|
|
|
|
SkAutoUnref(SkRefCnt* obj) : SkAutoTUnref<SkRefCnt>(obj) {}
|
2008-12-17 15:59:43 +00:00
|
|
|
};
|
|
|
|
|
2011-07-15 15:25:22 +00:00
|
|
|
class SkAutoRef : SkNoncopyable {
|
|
|
|
public:
|
|
|
|
SkAutoRef(SkRefCnt* obj) : fObj(obj) { SkSafeRef(obj); }
|
|
|
|
~SkAutoRef() { SkSafeUnref(fObj); }
|
|
|
|
private:
|
|
|
|
SkRefCnt* fObj;
|
|
|
|
};
|
2009-05-22 14:39:03 +00:00
|
|
|
|
2013-01-07 00:58:00 +00:00
|
|
|
/** Wrapper class for SkRefCnt pointers. This manages ref/unref of a pointer to
|
|
|
|
a SkRefCnt (or subclass) object.
|
|
|
|
*/
|
|
|
|
template <typename T> class SkRefPtr {
|
|
|
|
public:
|
|
|
|
SkRefPtr() : fObj(NULL) {}
|
|
|
|
SkRefPtr(T* obj) : fObj(obj) { SkSafeRef(fObj); }
|
|
|
|
SkRefPtr(const SkRefPtr& o) : fObj(o.fObj) { SkSafeRef(fObj); }
|
|
|
|
~SkRefPtr() { SkSafeUnref(fObj); }
|
|
|
|
|
|
|
|
SkRefPtr& operator=(const SkRefPtr& rp) {
|
|
|
|
SkRefCnt_SafeAssign(fObj, rp.fObj);
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
SkRefPtr& operator=(T* obj) {
|
|
|
|
SkRefCnt_SafeAssign(fObj, obj);
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
T* get() const { return fObj; }
|
|
|
|
T& operator*() const { return *fObj; }
|
|
|
|
T* operator->() const { return fObj; }
|
|
|
|
|
|
|
|
typedef T* SkRefPtr::*unspecified_bool_type;
|
|
|
|
operator unspecified_bool_type() const {
|
|
|
|
return fObj ? &SkRefPtr::fObj : NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
T* fObj;
|
|
|
|
};
|
|
|
|
|
2008-12-17 15:59:43 +00:00
|
|
|
#endif
|