dynamic_library.hpp

浏览该文件的文档.

#ifndef NEFORCE_PLUGIN_DYNAMIC_LIBRARY_HPP__
#define NEFORCE_PLUGIN_DYNAMIC_LIBRARY_HPP__

 
#include "NeForce/core/exception/system_exception.hpp"
NEFORCE_BEGIN_NAMESPACE__


struct dynamic_library_exception final : system_exception {
    explicit dynamic_library_exception(const char* info = "Dynamic Library Operation Failed.",
                                       const error_code code = last_error()) noexcept :
    system_exception(info, code) {}
 
    explicit dynamic_library_exception(const exception& e) :
    system_exception(e) {}
 
    ~dynamic_library_exception() override = default;
 
    NEFORCE_NODISCARD const char* type() const noexcept override { return "dynamic_library_exception"; }
};
 // Exceptions


class NEFORCE_API dynamic_library {
public:
    enum class load_mode : int {
        default_ = 0,      
        lazy = 1 << 0,     
        now = 1 << 1,      
        global = 1 << 2,   
        local = 1 << 3,    
        deep_bind = 1 << 4 
    };
 
private:
    void* handle_{nullptr};                    
    string path_;                              
    load_mode load_mode_{load_mode::default_}; 
 
private:
    void open();
    void close();
 
public:
    dynamic_library() noexcept = default;

    explicit dynamic_library(string pth);

    dynamic_library(string pth, load_mode mode);
 
    ~dynamic_library();
 
    dynamic_library(const dynamic_library&) = delete;
    dynamic_library& operator=(const dynamic_library&) = delete;

    dynamic_library(dynamic_library&& other) noexcept;

    dynamic_library& operator=(dynamic_library&& other) noexcept;

    template <typename T>
    T to_symbol(const string& name) const {
        return reinterpret_cast<T>(symbol(name));
    }

    NEFORCE_NODISCARD void* symbol(const string& name) const;

    NEFORCE_NODISCARD bool has_symbol(const string& name) const noexcept;

    NEFORCE_NODISCARD bool is_open() const noexcept { return handle_ != nullptr; }

    void unload() { close(); }

    NEFORCE_NODISCARD void* native_handle() const noexcept { return handle_; }

    NEFORCE_NODISCARD const string& path() const noexcept { return path_; }

    NEFORCE_NODISCARD load_mode get_load_mode() const noexcept { return load_mode_; }

    static dynamic_library load_self();

    static dynamic_library load_by_name(const string& name, load_mode mode = load_mode::default_);

    NEFORCE_NODISCARD vector<string> list_symbols(const string& name_filter = "") const;

    NEFORCE_NODISCARD static string program_location();

    NEFORCE_NODISCARD static string symbol_location(void* symbol_ptr);
};
 // DynamicLibrary
 
NEFORCE_END_NAMESPACE__
#endif // NEFORCE_PLUGIN_DYNAMIC_LIBRARY_HPP__