blender/intern/memutil/MEM_RefCounted.h
Campbell Barton c434782e3a File headers: SPDX License migration
Use a shorter/simpler license convention, stops the header taking so
much space.

Follow the SPDX license specification: https://spdx.org/licenses

- C/C++/objc/objc++
- Python
- Shell Scripts
- CMake, GNUmakefile

While most of the source tree has been included

- `./extern/` was left out.
- `./intern/cycles` & `./intern/atomic` are also excluded because they
  use different header conventions.

doc/license/SPDX-license-identifiers.txt has been added to list SPDX all
used identifiers.

See P2788 for the script that automated these edits.

Reviewed By: brecht, mont29, sergey

Ref D14069
2022-02-11 09:14:36 +11:00

88 lines
1.8 KiB
C++

/* SPDX-License-Identifier: GPL-2.0-or-later
* Copyright 2001-2002 NaN Holding BV. All rights reserved. */
/** \file
* \ingroup intern_memutil
*
* Declaration of MEM_RefCounted class.
*/
#ifndef __MEM_REFCOUNTED_H__
#define __MEM_REFCOUNTED_H__
/**
* An object with reference counting.
* Base class for objects with reference counting.
* When a shared object is ceated, it has reference count == 1.
* If the reference count of a shared object reaches zero, the object self-destructs.
* The default destructor of this object has been made protected on purpose.
* This disables the creation of shared objects on the stack.
*
* \author Maarten Gribnau
* \date March 31, 2001
*/
class MEM_RefCounted {
public:
/**
* Constructs a shared object.
*/
MEM_RefCounted() : m_refCount(1)
{
}
/**
* Returns the reference count of this object.
* \return the reference count.
*/
inline virtual int getRef() const;
/**
* Increases the reference count of this object.
* \return the new reference count.
*/
inline virtual int incRef();
/**
* Decreases the reference count of this object.
* If the reference count reaches zero, the object self-destructs.
* \return the new reference count.
*/
inline virtual int decRef();
protected:
/**
* Destructs a shared object.
* The destructor is protected to force the use of incRef and decRef.
*/
virtual ~MEM_RefCounted()
{
}
protected:
/** The reference count. */
int m_refCount;
};
inline int MEM_RefCounted::getRef() const
{
return m_refCount;
}
inline int MEM_RefCounted::incRef()
{
return ++m_refCount;
}
inline int MEM_RefCounted::decRef()
{
m_refCount--;
if (m_refCount == 0) {
delete this;
return 0;
}
return m_refCount;
}
#endif // __MEM_REFCOUNTED_H__