87 lines
2.9 KiB
C++
87 lines
2.9 KiB
C++
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library.
|
|
Copyright (c) 2017 - ROLI Ltd.
|
|
|
|
JUCE is an open source library subject to commercial or open-source
|
|
licensing.
|
|
|
|
The code included in this file is provided under the terms of the ISC license
|
|
http://www.isc.org/downloads/software-support-policy/isc-license. Permission
|
|
To use, copy, modify, and/or distribute this software for any purpose with or
|
|
without fee is hereby granted provided that the above copyright notice and
|
|
this permission notice appear in all copies.
|
|
|
|
JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
|
|
EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
|
|
DISCLAIMED.
|
|
|
|
==============================================================================
|
|
*/
|
|
|
|
namespace juce
|
|
{
|
|
|
|
/**
|
|
Handles the opening and closing of DLLs.
|
|
|
|
This class can be used to open a DLL and get some function pointers from it.
|
|
Since the DLL is freed when this object is deleted, it's handy for managing
|
|
library lifetimes using RAII.
|
|
|
|
@tags{Core}
|
|
*/
|
|
class JUCE_API DynamicLibrary
|
|
{
|
|
public:
|
|
/** Creates an unopened DynamicLibrary object.
|
|
Call open() to actually open one.
|
|
*/
|
|
DynamicLibrary() = default;
|
|
|
|
/**
|
|
*/
|
|
DynamicLibrary (const String& name) { open (name); }
|
|
|
|
/** Move constructor */
|
|
DynamicLibrary (DynamicLibrary&& other) noexcept
|
|
{
|
|
std::swap (handle, other.handle);
|
|
}
|
|
|
|
/** Destructor.
|
|
If a library is currently open, it will be closed when this object is destroyed.
|
|
*/
|
|
~DynamicLibrary() { close(); }
|
|
|
|
/** Opens a DLL.
|
|
The name and the method by which it gets found is of course platform-specific, and
|
|
may or may not include a path, depending on the OS.
|
|
If a library is already open when this method is called, it will first close the library
|
|
before attempting to load the new one.
|
|
@returns true if the library was successfully found and opened.
|
|
*/
|
|
bool open (const String& name);
|
|
|
|
/** Releases the currently-open DLL, or has no effect if none was open. */
|
|
void close();
|
|
|
|
/** Tries to find a named function in the currently-open DLL, and returns a pointer to it.
|
|
If no library is open, or if the function isn't found, this will return a null pointer.
|
|
*/
|
|
void* getFunction (const String& functionName) noexcept;
|
|
|
|
/** Returns the platform-specific native library handle.
|
|
You'll need to cast this to whatever is appropriate for the OS that's in use.
|
|
*/
|
|
void* getNativeHandle() const noexcept { return handle; }
|
|
|
|
private:
|
|
void* handle = nullptr;
|
|
|
|
JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (DynamicLibrary)
|
|
};
|
|
|
|
} // namespace juce
|