summaryrefslogtreecommitdiffstats
path: root/src/common/dynamic_library.h
blob: 2a06372fd89f64ad9c3d492ffdd802bfaeb030af (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
// Copyright 2019 Dolphin Emulator Project
// Licensed under GPLv2+
// Refer to the license.txt file included.

#pragma once

#include <string>

namespace Common {

/**
 * Provides a platform-independent interface for loading a dynamic library and retrieving symbols.
 * The interface maintains an internal reference count to allow one handle to be shared between
 * multiple users.
 */
class DynamicLibrary final {
public:
    /// Default constructor, does not load a library.
    explicit DynamicLibrary();

    /// Automatically loads the specified library. Call IsOpen() to check validity before use.
    explicit DynamicLibrary(const char* filename);

    /// Moves the library.
    DynamicLibrary(DynamicLibrary&&) noexcept;
    DynamicLibrary& operator=(DynamicLibrary&&) noexcept;

    /// Delete copies, we can't copy a dynamic library.
    DynamicLibrary(const DynamicLibrary&) = delete;
    DynamicLibrary& operator=(const DynamicLibrary&) = delete;

    /// Closes the library.
    ~DynamicLibrary();

    /// Returns the specified library name with the platform-specific suffix added.
    static std::string GetUnprefixedFilename(const char* filename);

    /// Returns the specified library name in platform-specific format.
    /// Major/minor versions will not be included if set to -1.
    /// If libname already contains the "lib" prefix, it will not be added again.
    /// Windows: LIBNAME-MAJOR-MINOR.dll
    /// Linux: libLIBNAME.so.MAJOR.MINOR
    /// Mac: libLIBNAME.MAJOR.MINOR.dylib
    static std::string GetVersionedFilename(const char* libname, int major = -1, int minor = -1);

    /// Returns true if a module is loaded, otherwise false.
    bool IsOpen() const {
        return handle != nullptr;
    }

    /// Loads (or replaces) the handle with the specified library file name.
    /// Returns true if the library was loaded and can be used.
    bool Open(const char* filename);

    /// Unloads the library, any function pointers from this library are no longer valid.
    void Close();

    /// Returns the address of the specified symbol (function or variable) as an untyped pointer.
    /// If the specified symbol does not exist in this library, nullptr is returned.
    void* GetSymbolAddress(const char* name) const;

    /// Obtains the address of the specified symbol, automatically casting to the correct type.
    /// Returns true if the symbol was found and assigned, otherwise false.
    template <typename T>
    bool GetSymbol(const char* name, T* ptr) const {
        *ptr = reinterpret_cast<T>(GetSymbolAddress(name));
        return *ptr != nullptr;
    }

private:
    /// Platform-dependent data type representing a dynamic library handle.
    void* handle = nullptr;
};

} // namespace Common