inviwo::SharedLibrary Class Reference

Loader for dll/so/dylib. Get functions from loaded library using findSymbol(...). More...

#include <inviwo/core/util/sharedlibrary.h>

Public Member Functions
void *	findSymbol (const std::string &name)
	Get function address from library.
template<typename T>
T	findSymbolTyped (const std::string &name)
	Get typed function address from library.
const std::filesystem::path &	getFilePath ()
SharedLibrary &	operator= (const SharedLibrary &that)=delete
SharedLibrary &	operator= (SharedLibrary &&that) noexcept
void	release ()
	SharedLibrary (const SharedLibrary &rhs)=delete
	SharedLibrary (const std::filesystem::path &filePath)
	SharedLibrary (SharedLibrary &&rhs) noexcept

Static Public Member Functions
static std::set< std::filesystem::path >	libraryFileExtensions ()

Detailed Description

Loader for dll/so/dylib. Get functions from loaded library using findSymbol(...).

Loads specified dll/so/dylib on construction and unloads it on destruction. Throws an inviwo::Exception if library failed to load.

Member Function Documentation

findSymbol()

void * inviwo::SharedLibrary::findSymbol

(

const std::string &

name

)

Get function address from library.

Example usage:

using f_getModule = InviwoModuleFactoryObject* (__stdcall *)();
auto moduleFunc = reinterpret_cast<f_getModule>(sharedLib->findSymbol("createModule"));

Parameters

name	Function name

Returns

Address to function if found, otherwise nullptr

findSymbolTyped()

template<typename T>

T inviwo::SharedLibrary::findSymbolTyped

(

const std::string &

name

)

Get typed function address from library.

Example usage:

using f_getModule = InviwoModuleFactoryObject* (__stdcall *)();
auto moduleFunc = sharedLib->findSymbolTyped<f_getModule>("createModule"));

Parameters

name	Function name

Returns

Address to function if found, otherwise nullptr

release()

void inviwo::SharedLibrary::release

(

)

Reset the handle and effectively leak the lib. Needed for some dll that crashes on exit otherwise

---

The documentation for this class was generated from the following file:

• include/inviwo/core/util/sharedlibrary.h