Class DynamicLibrary

choc/platform/choc_DynamicLibrary.h:31–57

============================================================================== A minimal cross-platform loader for .dll/.so files. */

    A minimal cross-platform loader for .dll/.so files.
*/
struct DynamicLibrary
{
    DynamicLibrary() = default;

    /// Attempts to load a library with the given name or path.
    DynamicLibrary (std::string_view library);

    DynamicLibrary (const DynamicLibrary&) = delete;
    DynamicLibrary& operator= (const DynamicLibrary&) = delete;
    DynamicLibrary (DynamicLibrary&&);
    DynamicLibrary& operator= (DynamicLibrary&&);

    /// On destruction, this object releases the library that was loaded
    ~DynamicLibrary();

    /// Returns a pointer to the function with this name, or nullptr if not found.
    void* findFunction (std::string_view functionName);

    /// Returns true if the library was successfully loaded
    operator bool() const noexcept              { return handle != nullptr; }

    /// Releases any handle that this object is holding
    void close();

    /// platform-specific handle. Will be nullptr if not loaded
    void* handle = nullptr;
};