author | simon <simon> | 2002-11-21 12:02:07 (UTC) |
---|---|---|
committer | simon <simon> | 2002-11-21 12:02:07 (UTC) |
commit | 58715bab157ca913a08b7ce26c230bbc0be5f70b (patch) (unidiff) | |
tree | c104abd25c1ed2450b8fe469701e77f2e132aa2d | |
parent | 74b4b55fd5f09c1b8f38228488aa5876e40c0ae3 (diff) | |
download | opie-58715bab157ca913a08b7ce26c230bbc0be5f70b.zip opie-58715bab157ca913a08b7ce26c230bbc0be5f70b.tar.gz opie-58715bab157ca913a08b7ce26c230bbc0be5f70b.tar.bz2 |
- backporting two changes from qt3:
- added QInterfacePtr template class to take over the tedious work
of manual refcounting on interface objects
- the QREFCOUNT macro no longer relies on the developer to declare
(and initialize!) a refcnt variable but defines a qtrefcount class
variable itself, that takes care of proper initialization
(fixes various missing refcounter initializations found)
Harlekin suggested to commit :)
-rw-r--r-- | library/qcom.h | 90 |
1 files changed, 89 insertions, 1 deletions
diff --git a/library/qcom.h b/library/qcom.h index 8c0fa60..9972d8f 100644 --- a/library/qcom.h +++ b/library/qcom.h | |||
@@ -1,83 +1,171 @@ | |||
1 | /********************************************************************** | 1 | /********************************************************************** |
2 | ** Copyright (C) 2000-2002 Trolltech AS. All rights reserved. | 2 | ** Copyright (C) 2000-2002 Trolltech AS. All rights reserved. |
3 | ** | 3 | ** |
4 | ** This file is part of the Qtopia Environment. | 4 | ** This file is part of the Qtopia Environment. |
5 | ** | 5 | ** |
6 | ** This file may be distributed and/or modified under the terms of the | 6 | ** This file may be distributed and/or modified under the terms of the |
7 | ** GNU General Public License version 2 as published by the Free Software | 7 | ** GNU General Public License version 2 as published by the Free Software |
8 | ** Foundation and appearing in the file LICENSE.GPL included in the | 8 | ** Foundation and appearing in the file LICENSE.GPL included in the |
9 | ** packaging of this file. | 9 | ** packaging of this file. |
10 | ** | 10 | ** |
11 | ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE | 11 | ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE |
12 | ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. | 12 | ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
13 | ** | 13 | ** |
14 | ** See http://www.trolltech.com/gpl/ for GPL licensing information. | 14 | ** See http://www.trolltech.com/gpl/ for GPL licensing information. |
15 | ** | 15 | ** |
16 | ** Contact info@trolltech.com if any conditions of this licensing are | 16 | ** Contact info@trolltech.com if any conditions of this licensing are |
17 | ** not clear to you. | 17 | ** not clear to you. |
18 | ** | 18 | ** |
19 | **********************************************************************/ | 19 | **********************************************************************/ |
20 | 20 | ||
21 | #ifndef QCOM_H | 21 | #ifndef QCOM_H |
22 | #define QCOM_H | 22 | #define QCOM_H |
23 | 23 | ||
24 | #include <qstringlist.h> | 24 | #include <qstringlist.h> |
25 | 25 | ||
26 | #ifndef QT_NO_COMPONENT | 26 | #ifndef QT_NO_COMPONENT |
27 | 27 | ||
28 | #include <qpe/quuid.h> | 28 | #include <qpe/quuid.h> |
29 | 29 | ||
30 | #define QRESULT unsigned long | 30 | #define QRESULT unsigned long |
31 | #define QS_OK (QRESULT)0x00000000 | 31 | #define QS_OK (QRESULT)0x00000000 |
32 | #define QS_FALSE (QRESULT)0x00000001 | 32 | #define QS_FALSE (QRESULT)0x00000001 |
33 | 33 | ||
34 | #define QE_NOTIMPL (QRESULT)0x80000001 | 34 | #define QE_NOTIMPL (QRESULT)0x80000001 |
35 | #define QE_OUTOFMEMORY (QRESULT)0x80000002 | 35 | #define QE_OUTOFMEMORY (QRESULT)0x80000002 |
36 | #define QE_INVALIDARG (QRESULT)0x80000003 | 36 | #define QE_INVALIDARG (QRESULT)0x80000003 |
37 | #define QE_NOINTERFACE (QRESULT)0x80000004 | 37 | #define QE_NOINTERFACE (QRESULT)0x80000004 |
38 | #define QE_NOCOMPONENT (QRESULT)0x80000005 | 38 | #define QE_NOCOMPONENT (QRESULT)0x80000005 |
39 | 39 | ||
40 | // {1D8518CD-E8F5-4366-99E8-879FD7E482DE} | 40 | // {1D8518CD-E8F5-4366-99E8-879FD7E482DE} |
41 | #ifndef IID_QUnknown | 41 | #ifndef IID_QUnknown |
42 | #define IID_QUnknown QUuid(0x1d8518cd, 0xe8f5, 0x4366, 0x99, 0xe8, 0x87, 0x9f, 0xd7, 0xe4, 0x82, 0xde) | 42 | #define IID_QUnknown QUuid(0x1d8518cd, 0xe8f5, 0x4366, 0x99, 0xe8, 0x87, 0x9f, 0xd7, 0xe4, 0x82, 0xde) |
43 | #endif | 43 | #endif |
44 | 44 | ||
45 | struct Q_EXPORT QUnknownInterface | 45 | struct Q_EXPORT QUnknownInterface |
46 | { | 46 | { |
47 | virtual QRESULT queryInterface( const QUuid&, QUnknownInterface** ) = 0; | 47 | virtual QRESULT queryInterface( const QUuid&, QUnknownInterface** ) = 0; |
48 | virtual ulong addRef() = 0; | 48 | virtual ulong addRef() = 0; |
49 | virtual ulong release() = 0; | 49 | virtual ulong release() = 0; |
50 | }; | 50 | }; |
51 | 51 | ||
52 | // {D16111D4-E1E7-4C47-8599-24483DAE2E07} | 52 | // {D16111D4-E1E7-4C47-8599-24483DAE2E07} |
53 | #ifndef IID_QLibrary | 53 | #ifndef IID_QLibrary |
54 | #define IID_QLibrary QUuid( 0xd16111d4, 0xe1e7, 0x4c47, 0x85, 0x99, 0x24, 0x48, 0x3d, 0xae, 0x2e, 0x07) | 54 | #define IID_QLibrary QUuid( 0xd16111d4, 0xe1e7, 0x4c47, 0x85, 0x99, 0x24, 0x48, 0x3d, 0xae, 0x2e, 0x07) |
55 | #endif | 55 | #endif |
56 | 56 | ||
57 | struct Q_EXPORT QLibraryInterface : public QUnknownInterface | 57 | struct Q_EXPORT QLibraryInterface : public QUnknownInterface |
58 | { | 58 | { |
59 | virtual bool init() = 0; | 59 | virtual bool init() = 0; |
60 | virtual void cleanup() = 0; | 60 | virtual void cleanup() = 0; |
61 | virtual bool canUnload() const = 0; | 61 | virtual bool canUnload() const = 0; |
62 | }; | 62 | }; |
63 | 63 | ||
64 | #define Q_CREATE_INSTANCE( IMPLEMENTATION ) \ | 64 | #define Q_CREATE_INSTANCE( IMPLEMENTATION ) \ |
65 | IMPLEMENTATION *i = new IMPLEMENTATION; \ | 65 | IMPLEMENTATION *i = new IMPLEMENTATION; \ |
66 | QUnknownInterface* iface = 0; \ | 66 | QUnknownInterface* iface = 0; \ |
67 | i->queryInterface( IID_QUnknown, &iface ); \ | 67 | i->queryInterface( IID_QUnknown, &iface ); \ |
68 | return iface; | 68 | return iface; |
69 | 69 | ||
70 | template <class T> | ||
71 | class QInterfacePtr | ||
72 | { | ||
73 | public: | ||
74 | QInterfacePtr():iface(0){} | ||
75 | |||
76 | QInterfacePtr( T* i) { | ||
77 | if ( (iface = i) ) | ||
78 | iface->addRef(); | ||
79 | } | ||
80 | |||
81 | QInterfacePtr(const QInterfacePtr<T> &p) { | ||
82 | if ( (iface = p.iface) ) | ||
83 | iface->addRef(); | ||
84 | } | ||
85 | |||
86 | ~QInterfacePtr() { | ||
87 | if ( iface ) | ||
88 | iface->release(); | ||
89 | } | ||
90 | |||
91 | QInterfacePtr<T> &operator=(const QInterfacePtr<T> &p) { | ||
92 | if ( iface != p.iface ) { | ||
93 | if ( iface ) | ||
94 | iface->release(); | ||
95 | if ( (iface = p.iface) ) | ||
96 | iface->addRef(); | ||
97 | } | ||
98 | return *this; | ||
99 | } | ||
100 | |||
101 | QInterfacePtr<T> &operator=(T* i) { | ||
102 | if (iface != i ) { | ||
103 | if ( iface ) | ||
104 | iface->release(); | ||
105 | if ( (iface = i) ) | ||
106 | iface->addRef(); | ||
107 | } | ||
108 | return *this; | ||
109 | } | ||
110 | |||
111 | bool operator==( const QInterfacePtr<T> &p ) const { return iface == p.iface; } | ||
112 | |||
113 | bool operator!= ( const QInterfacePtr<T>& p ) const { return !( *this == p ); } | ||
114 | |||
115 | bool isNull() const { return !iface; } | ||
116 | |||
117 | T* operator->() const { return iface; } | ||
118 | |||
119 | T& operator*() const { return *iface; } | ||
120 | |||
121 | operator T*() const { return iface; } | ||
122 | |||
123 | QUnknownInterface** operator &() const { | ||
124 | if( iface ) | ||
125 | iface->release(); | ||
126 | return (QUnknownInterface**)&iface; | ||
127 | } | ||
128 | |||
129 | T** operator &() { | ||
130 | if ( iface ) | ||
131 | iface->release(); | ||
132 | return &iface; | ||
133 | } | ||
134 | |||
135 | private: | ||
136 | T* iface; | ||
137 | }; | ||
138 | |||
139 | |||
140 | // internal class that wraps an initialized ulong | ||
141 | struct Q_EXPORT QtULong | ||
142 | { | ||
143 | QtULong() : ref( 0 ) { } | ||
144 | operator unsigned long () const { return ref; } | ||
145 | unsigned long& operator++() { return ++ref; } | ||
146 | unsigned long operator++( int ) { return ref++; } | ||
147 | unsigned long& operator--() { return --ref; } | ||
148 | unsigned long operator--( int ) { return ref--; } | ||
149 | |||
150 | unsigned long ref; | ||
151 | }; | ||
152 | |||
70 | #define Q_EXPORT_INTERFACE() \ | 153 | #define Q_EXPORT_INTERFACE() \ |
71 | extern "C" QUnknownInterface* ucm_instantiate() | 154 | extern "C" QUnknownInterface* ucm_instantiate() |
72 | 155 | ||
73 | #define Q_REFCOUNT ulong addRef() {return ref++;}ulong release() {if(!--ref){delete this;return 0;}return ref;} | 156 | #define Q_REFCOUNT \ |
157 | private: \ | ||
158 | QtULong qtrefcount; \ | ||
159 | public: \ | ||
160 | ulong addRef() {return qtrefcount++;} \ | ||
161 | ulong release() {if(!--qtrefcount){delete this;return 0;}return qtrefcount;} | ||
74 | 162 | ||
75 | #else // QT_NO_COMPONENT | 163 | #else // QT_NO_COMPONENT |
76 | 164 | ||
77 | struct Q_EXPORT QUnknownInterface | 165 | struct Q_EXPORT QUnknownInterface |
78 | { | 166 | { |
79 | }; | 167 | }; |
80 | 168 | ||
81 | #endif // QT_NO_COMPONENT | 169 | #endif // QT_NO_COMPONENT |
82 | 170 | ||
83 | #endif // QCOM_H | 171 | #endif // QCOM_H |