dynamiclib Class Reference

Inherits object.

Public Member Functions
	dynamiclib ()
	~dynamiclib ()
bool	open (const char *library, bool loaddependencies, bool global)
bool	close ()
void *	getSymbol (const char *symbol)
char *	getError ()
Public Member Functions inherited from object
virtual	~object ()

Static Public Member Functions
static void	setErrorMutex (threadmutex *mtx)

Detailed Description

The dynamiclib class provides methods for loading, unloading and calling functions from dynamically linked libraries.

Constructor & Destructor Documentation

dynamiclib()

dynamiclib::dynamiclib

(

)

Creates an instance of the dynamiclib class.

~dynamiclib()

dynamiclib::~dynamiclib

(

)

Deletes this instance of the dynamiclib class.

Member Function Documentation

close()

bool dynamiclib::close

(

)

Closes and unloads the previously opened library.

getError()

char* dynamiclib::getError

(

)

Returns a human-readable description of the previous error that occurred, or NULL if no error has occurred.

This method allocates a buffer internally and returns it. The calling program must deallocate the buffer.

getSymbol()

void* dynamiclib::getSymbol

(

const char *

symbol

)

Returns a handle to "symbol" (exported function or variable) in the currently open library or NULL if an error occurs or if no library is currently open.

open()

bool dynamiclib::open	(	const char *	library,
		bool	loaddependencies,
		bool	global
	)

Opens library "library". If "loaddependencies" is true, then all libraries required by this library are also loaded, if it is false, they are loaded later, as needed. If "global" is true, then the symbols defined in the library are made available to libraries which are loaded later.

Returns true on success and false on failure.

setErrorMutex()

static void dynamiclib::setErrorMutex ( threadmutex *  mtx )

static

getError() is not reentrant and thus not thread safe. If your application is multi-threaded and you use getError(), you must use this method to supply a mutex and ensure thread safety.

If you don't supply a mutex, getError() will still work, but will not be thread-safe.