1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
/*=========================================================================
Program: Visualization Toolkit
Module: vtkSmartPyObject.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
/**
* @class vtkSmartPyObject
*
* The vtkSmartPyObject class serves as a smart pointer for PyObjects.
*/
#ifndef vtkSmartPyObject_h
#define vtkSmartPyObject_h
// this must be included first
#include "vtkPython.h" // PyObject can't be forward declared
#include "vtkWrappingPythonCoreModule.h"
class VTKWRAPPINGPYTHONCORE_EXPORT vtkSmartPyObject {
public:
/**
* Creates a new vtkSmartPyObject managing the existing reference
* to the object given
*/
vtkSmartPyObject(PyObject *obj = NULL);
/**
* Creates a new vtkSmartPyObject to the object in the other smart
* pointer and increments the reference count to the object
*/
vtkSmartPyObject(const vtkSmartPyObject &other);
/**
* Decrements the reference count to the object
*/
~vtkSmartPyObject();
/**
* The internal pointer is copied from the other vtkSmartPyObject.
* The reference count on the old object is decremented and the
* reference count on the new object is incremented
*/
vtkSmartPyObject& operator=(const vtkSmartPyObject &other);
/**
* Sets the internal pointer to the given PyObject. The reference
* count on the PyObject is incremented. To take a reference without
* incrementing the reference count use TakeReference.
*/
vtkSmartPyObject& operator=(PyObject *obj);
/**
* Sets the internal pointer to the given PyObject without incrementing
* the reference count
*/
void TakeReference(PyObject* obj);
/**
* Provides normal pointer target member access using operator ->.
*/
PyObject *operator->() const;
/**
* Get the contained pointer.
*/
operator PyObject*() const;
/**
* Returns true if the internal pointer is to a valid PyObject.
*/
operator bool() const;
/**
* Returns the pointer to a PyObject stored internally and clears the
* internally stored pointer. The caller is responsible for calling
* Py_DECREF on the returned object when finished with it as this
* does not change the reference count.
*/
PyObject* ReleaseReference();
/**
* Returns the internal pointer to a PyObject with no effect on its
* reference count
*/
PyObject *GetPointer() const;
/**
* Returns the internal pointer to a PyObject and incrments its reference
* count
*/
PyObject* GetAndIncreaseReferenceCount();
private:
PyObject *Object;
};
#endif
|
