summaryrefslogtreecommitdiff
authorsimon <simon>2002-11-21 12:02:07 (UTC)
committer simon <simon>2002-11-21 12:02:07 (UTC)
commit58715bab157ca913a08b7ce26c230bbc0be5f70b (patch) (unidiff)
treec104abd25c1ed2450b8fe469701e77f2e132aa2d
parent74b4b55fd5f09c1b8f38228488aa5876e40c0ae3 (diff)
downloadopie-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 :)
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--library/qcom.h90
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
45struct Q_EXPORT QUnknownInterface 45struct 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
57struct Q_EXPORT QLibraryInterface : public QUnknownInterface 57struct 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
70template <class T>
71class QInterfacePtr
72{
73public:
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
135private:
136 T* iface;
137};
138
139
140// internal class that wraps an initialized ulong
141struct 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 \
157private: \
158 QtULong qtrefcount; \
159public: \
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
77struct Q_EXPORT QUnknownInterface 165struct 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