IMP
2.0.0
The Integrative Modeling Platform
|
A reference counted pointer to an object. More...
#include <IMP/base/Pointer.h>
Public Types | |
typedef internal::PointerBase < internal::RefCountedPointerTraits < O > > | P |
Public Member Functions | |
template<class Any > | |
Pointer (const Any &o) | |
template<class OT > | |
Pointer< O > & | operator= (const internal::PointerBase< OT > &o) |
template<class OT > | |
Pointer< O > & | operator= (OT *o) |
Pointer< O > & | operator= (nullptr_t o) |
Pointer< O > & | operator= (const P &o) |
Any time you store an Object in a C++ program, you should use a Pointer, rather than a raw C++ pointer. Using a pointer manages the reference counting and makes sure that the object is not deleted prematurely when, for example, all Python references go away and that it is deleted properly if an exception is thrown during the function. Use the IMP_NEW() macro to aid creation of pointers to new objects.
For example, when implementing a Restraint that uses a PairScore, store the PairScore like this:
When creating Object instances in C++, you should write code like:
which is equivalent to
There are several important things to note in this code:
[in] | O | The type of IMP::RefCounted-derived object to point to |
Definition at line 73 of file base/Pointer.h.