.TH "KLibrary" 3 "28 Jan 2004" "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
.RI "\fIReturns the name of the library. \fP"
.ti -1c
.RI "\fBQString\fP \fBfileName\fP () const "
.br
.RI "\fIReturns the file name of the library. \fP"
.ti -1c
.RI "\fBKLibFactory\fP * \fBfactory\fP ()"
.br
.RI "\fIReturns the factory of the library. \fP"
.ti -1c
.RI "void * \fBsymbol\fP (const  char *name) const "
.br
.RI "\fILooks up a symbol from the library. \fP"
.ti -1c
.RI "bool \fBhasSymbol\fP (const  char *name) const "
.br
.RI "\fILooks up a symbol from the library. \fP"
.ti -1c
.RI "void \fBunload\fP () const "
.br
.RI "\fIUnloads the library. \fP"
.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.
.PP
\fBAuthor:\fP
.RS 4
Torben Weis <weis@kde.org> 
.RE
.PP

.PP
Definition at line 48 of file klibloader.h.
.SH "Member Function Documentation"
.PP 
.SS "\fBQString\fP KLibrary::name () const"
.PP
Returns the name of the library. \fBReturns:\fP
.RS 4
The name of the library like 'libkspread'. 
.RE
.PP
Reimplemented from \fBQObject\fP.
.PP
Definition at line 130 of file klibloader.cpp.
.PP
Referenced by factory(), and unload().
.SS "\fBQString\fP KLibrary::fileName () const"
.PP
Returns the file name of the library. \fBReturns:\fP
.RS 4
The filename of the library, for example '/opt/kde2&/lib/libkspread.la' 
.RE
.PP
Definition at line 135 of file klibloader.cpp.
.SS "\fBKLibFactory\fP * KLibrary::factory ()"
.PP
Returns the factory of the library. \fBReturns:\fP
.RS 4
The factory of the library if there is any, otherwise 0 
.RE
.PP
Definition at line 140 of file klibloader.cpp.
.PP
References QObject::connect(), name(), 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. 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
Definition at line 171 of file klibloader.cpp.
.PP
Referenced by factory().
.SS "bool KLibrary::hasSymbol (const char * name) const"
.PP
Looks up a symbol from the library. 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
Definition at line 183 of file klibloader.cpp.
.SS "void KLibrary::unload () const"
.PP
Unloads the library. This typically results in the deletion of this object. You should not reference its pointer after calling this function. Definition at line 189 of file klibloader.cpp.
.PP
References QFile::encodeName(), name(), and KLibLoader::unloadLibrary().

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