dl.hpp

Go to the documentation of this file.

#pragma once
 
/// @file
/// @ingroup dylib
/// Dynamic library loading and symbol lookup.
 
#include <guanaqo/dl-flags.hpp>
#include <guanaqo/export.h>
#include <filesystem>
#include <memory>
#include <stdexcept>
 
namespace guanaqo {
 
/// Failed to load a DLL or SO file, or failed to access a function in it.
/// @ingroup dylib
struct GUANAQO_EXPORT dynamic_load_error : std::runtime_error {
    using std::runtime_error::runtime_error;
};
 
/// Load a DLL or DSO file.
/// @ingroup dylib
GUANAQO_EXPORT std::shared_ptr<void>
load_lib(const std::filesystem::path &so_filename, DynamicLoadFlags flags);
/// Get a pointer to a function inside of a loaded DLL or SO file.
/// @ingroup dylib
GUANAQO_EXPORT void *load_func(void *lib_handle, const std::string &name);
 
} // namespace guanaqo