.TH "KLibrary" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdecore Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KLibrary \- Represents a dynamically loaded library.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <klibloader.h>\fP
.PP
Inherits \fBQObject\fP.
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKLibrary\fP (const \fBQString\fP &libname, const \fBQString\fP &filename, void *handle)"
.br
.ti -1c
.RI "\fBQString\fP \fBname\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBfileName\fP () const "
.br
.ti -1c
.RI "\fBKLibFactory\fP * \fBfactory\fP ()"
.br
.ti -1c
.RI "void * \fBsymbol\fP (const char *name) const "
.br
.ti -1c
.RI "bool \fBhasSymbol\fP (const char *name) const "
.br
.ti -1c
.RI "void \fBunload\fP () const "
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "class \fBKLibLoader\fP"
.br
.ti -1c
.RI "class \fBQAsciiDict<KLibrary>\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
Represents a dynamically loaded library. 

KLibrary allows you to look up symbols of the shared library. Use \fBKLibLoader\fP to create a new instance of KLibrary.
.PP
\fBSee also:\fP
.RS 4
\fBKLibLoader\fP 
.RE
.PP
\fBAuthor:\fP
.RS 4
Torben Weis <weis@kde.org> 
.RE
.PP

.PP
Definition at line 50 of file klibloader.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KLibrary::KLibrary (const \fBQString\fP & libname, const \fBQString\fP & filename, void * handle)"
.PP
Don't create KLibrary objects on your own. 
.PP
Instead use \fBKLibLoader\fP. 
.PP
Definition at line 98 of file klibloader.cpp.
.PP
References KLibLoader::self().
.SH "Member Function Documentation"
.PP 
.SS "\fBQString\fP KLibrary::name () const"
.PP
Returns the name of the library. 
.PP
\fBReturns:\fP
.RS 4
The name of the library like 'libkspread'. 
.RE
.PP

.PP
Reimplemented from \fBQObject\fP.
.PP
Definition at line 136 of file klibloader.cpp.
.PP
Referenced by factory(), and unload().
.SS "\fBQString\fP KLibrary::fileName () const"
.PP
Returns the file name of the library. 
.PP
\fBReturns:\fP
.RS 4
The filename of the library, for example '/opt/kde2&/lib/libkspread.la' 
.RE
.PP

.PP
Definition at line 141 of file klibloader.cpp.
.SS "\fBKLibFactory\fP * KLibrary::factory ()"
.PP
Returns the factory of the library. 
.PP
\fBReturns:\fP
.RS 4
The factory of the library if there is any, otherwise 0 
.RE
.PP

.PP
Definition at line 146 of file klibloader.cpp.
.PP
References QString::arg(), QObject::connect(), KLibLoader::d, endl(), name(), KLibLoader::self(), QCString::sprintf(), and symbol().
.PP
Referenced by KLibLoader::factory().
.SS "void * KLibrary::symbol (const char * name) const"
.PP
Looks up a symbol from the library. 
.PP
This is a very low level function that you usually don't want to use. Usually you should check using \fBhasSymbol()\fP whether the symbol actually exists, otherwise a warning will be printed. 
.PP
\fBParameters:\fP
.RS 4
\fIname\fP the name of the symbol to look up 
.RE
.PP
\fBReturns:\fP
.RS 4
the address of the symbol, or 0 if it does not exist 
.RE
.PP
\fBSee also:\fP
.RS 4
\fBhasSymbol\fP 
.RE
.PP

.PP
Definition at line 179 of file klibloader.cpp.
.PP
References KLibLoader::d, endl(), QString::fromLatin1(), and KLibLoader::self().
.PP
Referenced by factory().
.SS "bool KLibrary::hasSymbol (const char * name) const"
.PP
Looks up a symbol from the library. 
.PP
This is a very low level function that you usually don't want to use. Unlike \fBsymbol()\fP, this method doesn't warn if the symbol doesn't exist, so if the symbol might or might not exist, better use \fBhasSymbol()\fP before \fBsymbol()\fP. 
.PP
\fBParameters:\fP
.RS 4
\fIname\fP the name of the symbol to check 
.RE
.PP
\fBReturns:\fP
.RS 4
true if the symbol exists 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP

.PP
Definition at line 192 of file klibloader.cpp.
.SS "void KLibrary::unload () const"
.PP
Unloads the library. 
.PP
This typically results in the deletion of this object. You should not reference its pointer after calling this function. 
.PP
Definition at line 198 of file klibloader.cpp.
.PP
References name(), and KLibLoader::unloadLibrary().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdecore Library from the source code.
