]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: wx/ptr_scpd.h | |
3 | // Purpose: scoped smart pointer class | |
4 | // Author: Jesse Lovelace <jllovela@eos.ncsu.edu> | |
5 | // Modified by: | |
6 | // Created: 06/01/02 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) Jesse Lovelace and original Boost authors (see below) | |
9 | // Licence: wxWindows licence | |
10 | ///////////////////////////////////////////////////////////////////////////// | |
11 | ||
12 | // This class closely follows the implementation of the boost | |
13 | // library scoped_ptr and is an adaption for c++ macro's in | |
14 | // the wxWindows project. The original authors of the boost | |
15 | // scoped_ptr are given below with their respective copyrights. | |
16 | ||
17 | // (C) Copyright Greg Colvin and Beman Dawes 1998, 1999. | |
18 | // Copyright (c) 2001, 2002 Peter Dimov | |
19 | // | |
20 | // Permission to copy, use, modify, sell and distribute this software | |
21 | // is granted provided this copyright notice appears in all copies. | |
22 | // This software is provided "as is" without express or implied | |
23 | // warranty, and with no claim as to its suitability for any purpose. | |
24 | // | |
25 | // See http://www.boost.org/libs/smart_ptr/scoped_ptr.htm for documentation. | |
26 | // | |
27 | ||
28 | #ifndef __WX_SCOPED_POINTER__ | |
29 | #define __WX_SCOPED_POINTER__ | |
30 | ||
31 | #include "wx/defs.h" | |
32 | ||
33 | /* | |
34 | checked deleters are used to make sure that the type being deleted is really | |
35 | a complete type.: otherwise sizeof() would result in a compile-time error | |
36 | ||
37 | do { ... } while ( 0 ) construct is used to have an anonymous scope | |
38 | (otherwise we could have name clashes between different "complete"s) but | |
39 | still force a semicolon after the macro | |
40 | */ | |
41 | ||
42 | #define wxCHECKED_DELETE(ptr) \ | |
43 | do \ | |
44 | { \ | |
45 | typedef char complete[sizeof(*ptr)]; \ | |
46 | delete ptr; \ | |
47 | } while ( 0 ) | |
48 | ||
49 | #define wxCHECKED_DELETE_ARRAY(ptr) \ | |
50 | do \ | |
51 | { \ | |
52 | typedef char complete[sizeof(*ptr)]; \ | |
53 | delete [] ptr; \ | |
54 | } while ( 0 ) | |
55 | ||
56 | /* These scoped pointers are *not* assignable and cannot be used | |
57 | within a container. Look for wxDECLARE_SHARED_PTR for this | |
58 | functionality. | |
59 | ||
60 | In addition, the type being used *must* be complete at the time | |
61 | that wxDEFINE_SCOPED_* is called or a compiler error will result. | |
62 | This is because the class checks for the completeness of the type | |
63 | being used. | |
64 | */ | |
65 | ||
66 | ||
67 | #define wxDECLARE_SCOPED_PTR(T, name) \ | |
68 | class name \ | |
69 | { \ | |
70 | private: \ | |
71 | T * m_ptr; \ | |
72 | \ | |
73 | name(name const &); \ | |
74 | name & operator=(name const &); \ | |
75 | \ | |
76 | public: \ | |
77 | wxEXPLICIT name(T * ptr = NULL) \ | |
78 | : m_ptr(ptr) { } \ | |
79 | \ | |
80 | ~name(); \ | |
81 | \ | |
82 | void reset(T * ptr = NULL) \ | |
83 | { \ | |
84 | if (m_ptr != ptr) \ | |
85 | { \ | |
86 | delete m_ptr; \ | |
87 | m_ptr = ptr; \ | |
88 | } \ | |
89 | } \ | |
90 | \ | |
91 | T *release() \ | |
92 | { \ | |
93 | T *ptr = m_ptr; \ | |
94 | m_ptr = NULL; \ | |
95 | return ptr; \ | |
96 | } \ | |
97 | \ | |
98 | T & operator*() const \ | |
99 | { \ | |
100 | wxASSERT(m_ptr != NULL); \ | |
101 | return *m_ptr; \ | |
102 | } \ | |
103 | \ | |
104 | T * operator->() const \ | |
105 | { \ | |
106 | wxASSERT(m_ptr != NULL); \ | |
107 | return m_ptr; \ | |
108 | } \ | |
109 | \ | |
110 | T * get() const \ | |
111 | { \ | |
112 | return m_ptr; \ | |
113 | } \ | |
114 | \ | |
115 | void swap(name & ot) \ | |
116 | { \ | |
117 | T * tmp = ot.m_ptr; \ | |
118 | ot.m_ptr = m_ptr; \ | |
119 | m_ptr = tmp; \ | |
120 | } \ | |
121 | }; | |
122 | ||
123 | #define wxDEFINE_SCOPED_PTR(T, name)\ | |
124 | name::~name() \ | |
125 | { \ | |
126 | wxCHECKED_DELETE(m_ptr); \ | |
127 | } | |
128 | ||
129 | #define wxDECLARE_SCOPED_ARRAY(T, name)\ | |
130 | class name \ | |
131 | { \ | |
132 | private: \ | |
133 | T * m_ptr; \ | |
134 | name(name const &); \ | |
135 | name & operator=(name const &); \ | |
136 | \ | |
137 | public: \ | |
138 | wxEXPLICIT name(T * p = NULL) : m_ptr(p) \ | |
139 | {} \ | |
140 | \ | |
141 | ~name(); \ | |
142 | void reset(T * p = NULL); \ | |
143 | \ | |
144 | T & operator[](long int i) const\ | |
145 | { \ | |
146 | wxASSERT(m_ptr != NULL); \ | |
147 | wxASSERT(i >= 0); \ | |
148 | return m_ptr[i]; \ | |
149 | } \ | |
150 | \ | |
151 | T * get() const \ | |
152 | { \ | |
153 | return m_ptr; \ | |
154 | } \ | |
155 | \ | |
156 | void swap(name & ot) \ | |
157 | { \ | |
158 | T * tmp = ot.m_ptr; \ | |
159 | ot.m_ptr = m_ptr; \ | |
160 | m_ptr = tmp; \ | |
161 | } \ | |
162 | }; | |
163 | ||
164 | #define wxDEFINE_SCOPED_ARRAY(T, name) \ | |
165 | name::~name() \ | |
166 | { \ | |
167 | wxCHECKED_DELETE_ARRAY(m_ptr); \ | |
168 | } \ | |
169 | void name::reset(T * p){ \ | |
170 | if (m_ptr != p) \ | |
171 | { \ | |
172 | wxCHECKED_DELETE_ARRAY(m_ptr); \ | |
173 | m_ptr = p; \ | |
174 | } \ | |
175 | } | |
176 | ||
177 | #endif |