summaryrefslogtreecommitdiffabout
path: root/microkde/kdecore/klibloader.h
Unidiff
Diffstat (limited to 'microkde/kdecore/klibloader.h') (more/less context) (ignore whitespace changes)
-rw-r--r--microkde/kdecore/klibloader.h10
1 files changed, 5 insertions, 5 deletions
diff --git a/microkde/kdecore/klibloader.h b/microkde/kdecore/klibloader.h
index ed57109..53d146e 100644
--- a/microkde/kdecore/klibloader.h
+++ b/microkde/kdecore/klibloader.h
@@ -1,79 +1,79 @@
1/* This file is part of the KDE libraries 1/* This file is part of the KDE libraries
2 Copyright (C) 1999 Torben Weis <weis@kde.org> 2 Copyright (C) 1999 Torben Weis <weis@kde.org>
3 3
4 This library is free software; you can redistribute it and/or 4 This library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public 5 modify it under the terms of the GNU Library General Public
6 License version 2 as published by the Free Software Foundation. 6 License version 2 as published by the Free Software Foundation.
7 7
8 This library is distributed in the hope that it will be useful, 8 This library is distributed in the hope that it will be useful,
9 but WITHOUT ANY WARRANTY; without even the implied warranty of 9 but WITHOUT ANY WARRANTY; without even the implied warranty of
10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 Library General Public License for more details. 11 Library General Public License for more details.
12 12
13 You should have received a copy of the GNU Library General Public License 13 You should have received a copy of the GNU Library General Public License
14 along with this library; see the file COPYING.LIB. If not, write to 14 along with this library; see the file COPYING.LIB. If not, write to
15 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, 15 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
16 Boston, MA 02111-1307, USA. 16 Boston, MA 02111-1307, USA.
17*/ 17*/
18#ifndef KLIBLOADER_H 18#ifndef KLIBLOADER_H
19#define KLIBLOADER_H 19#define KLIBLOADER_H
20 20
21#include <qobject.h> 21#include <qobject.h>
22#include <qstring.h> 22#include <qstring.h>
23#include <qstringlist.h> 23#include <qstringlist.h>
24#include <qasciidict.h> 24#include <q3asciidict.h>
25#include <qptrlist.h> 25#include <q3ptrlist.h>
26#include <kglobal.h> 26#include <kglobal.h>
27 27
28#include <stdlib.h> // For backwards compatibility 28#include <stdlib.h> // For backwards compatibility
29 29
30class KInstance; 30class KInstance;
31class QTimer; 31class QTimer;
32class KLibrary; 32class KLibrary;
33class KLibFactory; 33class KLibFactory;
34class KLibFactoryPrivate; 34class KLibFactoryPrivate;
35class KLibLoaderPrivate; 35class KLibLoaderPrivate;
36class KLibraryPrivate; 36class KLibraryPrivate;
37 37
38class QLibrary; 38class QLibrary;
39 39
40#define K_EXPORT_COMPONENT_FACTORY( libname, factory ) \ 40#define K_EXPORT_COMPONENT_FACTORY( libname, factory ) \
41 extern "C" { void *init_##libname() { return new factory; } } 41 extern "C" { void *init_##libname() { return new factory; } }
42 42
43/** 43/**
44 * @short Represents a dynamically loaded library. 44 * @short Represents a dynamically loaded library.
45 * 45 *
46 * KLibrary allows you to look up symbols of the shared library. 46 * KLibrary allows you to look up symbols of the shared library.
47 * Use @ref KLibLoader to create a new instance of KLibrary. 47 * Use @ref KLibLoader to create a new instance of KLibrary.
48 * 48 *
49 * @see KLibLoader 49 * @see KLibLoader
50 * @author Torben Weis <weis@kde.org> 50 * @author Torben Weis <weis@kde.org>
51 */ 51 */
52class KLibrary : public QObject 52class KLibrary : public QObject
53{ 53{
54 friend class KLibLoader; 54 friend class KLibLoader;
55 friend class QAsciiDict<KLibrary>; 55 friend class Q3AsciiDict<KLibrary>;
56 56
57 Q_OBJECT 57 Q_OBJECT
58public: 58public:
59 /** 59 /**
60 * @internal 60 * @internal
61 * Don't create KLibrary objects on your own. Instead use @ref KLibLoader. 61 * Don't create KLibrary objects on your own. Instead use @ref KLibLoader.
62 */ 62 */
63//US KLibrary( const QString& libname, const QString& filename, void * handle ); 63//US KLibrary( const QString& libname, const QString& filename, void * handle );
64 KLibrary( const QString& libname, const QString& filename, QLibrary* handle ); 64 KLibrary( const QString& libname, const QString& filename, QLibrary* handle );
65 65
66 /** 66 /**
67 * Returns the name of the library. 67 * Returns the name of the library.
68 * @return The name of the library like "libkspread". 68 * @return The name of the library like "libkspread".
69 */ 69 */
70 QString name() const; 70 QString name() const;
71 71
72 /** 72 /**
73 * Returns the file name of the library. 73 * Returns the file name of the library.
74 * @return The filename of the library, for example "/opt/kde2&/lib/libkspread.la" 74 * @return The filename of the library, for example "/opt/kde2&/lib/libkspread.la"
75 */ 75 */
76 QString fileName() const; 76 QString fileName() const;
77 77
78 /** 78 /**
79 * Returns the factory of the library. 79 * Returns the factory of the library.
@@ -106,49 +106,49 @@ public:
106 /** 106 /**
107 * Unloads the library. 107 * Unloads the library.
108 * This typically results in the deletion of this object. You should 108 * This typically results in the deletion of this object. You should
109 * not reference its pointer after calling this function. 109 * not reference its pointer after calling this function.
110 */ 110 */
111 void unload() const; 111 void unload() const;
112 112
113private slots: 113private slots:
114 void slotObjectCreated( QObject *obj ); 114 void slotObjectCreated( QObject *obj );
115 void slotObjectDestroyed(); 115 void slotObjectDestroyed();
116 void slotTimeout(); 116 void slotTimeout();
117 117
118private: 118private:
119 /** 119 /**
120 * @internal 120 * @internal
121 * Don't destruct KLibrary objects yourself. Instead use @ref unload() instead. 121 * Don't destruct KLibrary objects yourself. Instead use @ref unload() instead.
122 */ 122 */
123 ~KLibrary(); 123 ~KLibrary();
124 124
125 QString m_libname; 125 QString m_libname;
126 QString m_filename; 126 QString m_filename;
127 KLibFactory* m_factory; 127 KLibFactory* m_factory;
128//US void * m_handle; 128//US void * m_handle;
129 QLibrary* m_handle; 129 QLibrary* m_handle;
130 QPtrList<QObject> m_objs; 130 Q3PtrList<QObject> m_objs;
131 QTimer *m_timer; 131 QTimer *m_timer;
132 KLibraryPrivate *d; 132 KLibraryPrivate *d;
133}; 133};
134 134
135class KLibWrapPrivate; 135class KLibWrapPrivate;
136 136
137/** 137/**
138 * The KLibLoader allows you to load libraries dynamically at runtime. 138 * The KLibLoader allows you to load libraries dynamically at runtime.
139 * Dependent libraries are loaded automatically. 139 * Dependent libraries are loaded automatically.
140 * 140 *
141 * KLibLoader follows the singleton pattern. You can not create multiple 141 * KLibLoader follows the singleton pattern. You can not create multiple
142 * instances. Use @ref self() to get a pointer to the loader. 142 * instances. Use @ref self() to get a pointer to the loader.
143 * 143 *
144 * @see KLibrary 144 * @see KLibrary
145 * @author Torben Weis <weis@kde.org> 145 * @author Torben Weis <weis@kde.org>
146 */ 146 */
147class KLibLoader : public QObject 147class KLibLoader : public QObject
148{ 148{
149 friend class KLibrary; 149 friend class KLibrary;
150 150
151 Q_OBJECT 151 Q_OBJECT
152public: 152public:
153 /** 153 /**
154 * You should NEVER destruct an instance of KLibLoader 154 * You should NEVER destruct an instance of KLibLoader
@@ -266,49 +266,49 @@ public:
266 * being called in all cases, whether the library is unloaded 266 * being called in all cases, whether the library is unloaded
267 * while the application is running or when exiting. 267 * while the application is running or when exiting.
268 */ 268 */
269 static void cleanUp(); 269 static void cleanUp();
270 270
271 /** 271 /**
272 * Helper method which looks for a library in the standard paths 272 * Helper method which looks for a library in the standard paths
273 * ("module" and "lib" resources). 273 * ("module" and "lib" resources).
274 * Made public for code that doesn't use KLibLoader itself, but still 274 * Made public for code that doesn't use KLibLoader itself, but still
275 * wants to open modules. 275 * wants to open modules.
276 * @param name of the library. If it is not a path, the function searches in 276 * @param name of the library. If it is not a path, the function searches in
277 * the "module" and "lib" resources. If there is no extension, 277 * the "module" and "lib" resources. If there is no extension,
278 * ".la" will be appended. 278 * ".la" will be appended.
279 * @param instance a KInstance used to get the standard paths 279 * @param instance a KInstance used to get the standard paths
280 */ 280 */
281 static QString findLibrary( const char * name/*US , const KInstance * instance = KGlobal::instance()*/ ); 281 static QString findLibrary( const char * name/*US , const KInstance * instance = KGlobal::instance()*/ );
282 282
283protected: 283protected:
284 KLibLoader( QObject* parent = 0, const char* name = 0 ); 284 KLibLoader( QObject* parent = 0, const char* name = 0 );
285 285
286private slots: 286private slots:
287 void slotLibraryDestroyed(); 287 void slotLibraryDestroyed();
288private: 288private:
289 void close_pending( KLibWrapPrivate * ); 289 void close_pending( KLibWrapPrivate * );
290 QAsciiDict<KLibWrapPrivate> m_libs; 290 Q3AsciiDict<KLibWrapPrivate> m_libs;
291 291
292 static KLibLoader* s_self; 292 static KLibLoader* s_self;
293 293
294protected: 294protected:
295 virtual void virtual_hook( int id, void* data ); 295 virtual void virtual_hook( int id, void* data );
296private: 296private:
297 KLibLoaderPrivate *d; 297 KLibLoaderPrivate *d;
298}; 298};
299 299
300/** 300/**
301 * If you develop a library that is to be loaded dynamically at runtime, then 301 * If you develop a library that is to be loaded dynamically at runtime, then
302 * you should return a pointer to your factory. The K_EXPORT_COMPONENT_FACTORY 302 * you should return a pointer to your factory. The K_EXPORT_COMPONENT_FACTORY
303 * macro is provided for this purpose: 303 * macro is provided for this purpose:
304 * <pre> 304 * <pre>
305 * K_EXPORT_COMPONENT_FACTORY( libkspread, KSpreadFactory ) 305 * K_EXPORT_COMPONENT_FACTORY( libkspread, KSpreadFactory )
306 * </pre> 306 * </pre>
307 * 307 *
308 * The first macro argument is the name of your library, the second specifies the name 308 * The first macro argument is the name of your library, the second specifies the name
309 * of your factory. 309 * of your factory.
310 * 310 *
311 * In the constructor of your factory you should create an instance of @ref KInstance 311 * In the constructor of your factory you should create an instance of @ref KInstance
312 * like this: 312 * like this:
313 * <pre> 313 * <pre>
314 * s_global = new KInstance( "kspread" ); 314 * s_global = new KInstance( "kspread" );