X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/34138703c3997ce676a1e713d9ff9eb020640da7..794bcc2dea743ac907b839f54e451847c9ea4b72:/include/wx/dynlib.h diff --git a/include/wx/dynlib.h b/include/wx/dynlib.h index 428048ce14..313180829c 100644 --- a/include/wx/dynlib.h +++ b/include/wx/dynlib.h @@ -1,95 +1,166 @@ +///////////////////////////////////////////////////////////////////////////// +// Name: dynlib.cpp +// Purpose: Dynamic library management +// Author: Guilhem Lavaux +// Modified by: +// Created: 20/07/98 +// RCS-ID: $Id$ +// Copyright: (c) Guilhem Lavaux +// Licence: wxWindows license +///////////////////////////////////////////////////////////////////////////// + #ifndef _WX_DYNLIB_H__ #define _WX_DYNLIB_H__ #ifdef __GNUG__ -#pragma interface +# pragma interface #endif -#include -#include -#include - -// --------------------------------------------------------------------------- -// Some more info on a class - -typedef struct { - wxClassInfo *class_info; - wxString path; -} wxClassLibInfo; +#include "wx/setup.h" + +#if wxUSE_DYNLIB_CLASS + +#include "wx/string.h" +#include "wx/list.h" +#include "wx/hash.h" + +// this is normally done by configure, but I leave it here for now... +#if defined(__UNIX__) && !(defined(HAVE_DLOPEN) || defined(HAVE_SHL_LOAD)) +# if defined(__LINUX__) || defined(__SOLARIS__) || defined(__SUNOS__) || defined(__FREEBSD__) +# define HAVE_DLOPEN +# elif defined(__HPUX__) +# define HAVE_SHL_LOAD +# endif // Unix flavour +#endif // !Unix or already have some HAVE_xxx defined + +// Note: WXPM/EMX has to be tested first, since we want to use +// native version, even if configure detected presence of DLOPEN. +#if defined(__WXPM__) || defined(__EMX__) +# define INCL_DOS +# include + typedef HMODULE wxDllType; +#elif defined(HAVE_DLOPEN) +# include + typedef void *wxDllType; +#elif defined(HAVE_SHL_LOAD) +# include + typedef shl_t wxDllType; +#elif defined(__WINDOWS__) +# include // needed to get HMODULE + typedef HMODULE wxDllType; +#elif defined(__WXMAC__) + typedef CFragConnectionID wxDllType; +#else +# error "wxLibrary can't be compiled on this platform, sorry." +#endif // OS + +// LoadLibrary is defined in windows.h as LoadLibraryA, but wxDllLoader method +// should be called LoadLibrary, not LoadLibraryA or LoadLibraryW! +#if defined(__WIN32__) && defined(LoadLibrary) +# include "wx/msw/winundef.h" +#endif -// --------------------------------------------------------------------------- -// Useful arrays +// ---------------------------------------------------------------------------- +// wxDllLoader +// ---------------------------------------------------------------------------- + +/** wxDllLoader is a class providing an interface similar to unix's + dlopen(). It is used by the wxLibrary framework and manages the + actual loading of DLLs and the resolving of symbols in them. + There are no instances of this class, it simply serves as a + namespace for its static member functions. +*/ +class wxDllLoader +{ +public: + /** This function loads a shared library into memory, with libname + being the basename of the library, without the filename + extension. No initialisation of the library will be done. + @param libname Name of the shared object to load. + @param success Must point to a bool variable which will be set to TRUE or FALSE. + @return A handle to the loaded DLL. Use success parameter to test if it is valid. + */ + static wxDllType LoadLibrary(const wxString & libname, bool *success = NULL); + /** This function unloads the shared library. */ + static void UnloadLibrary(wxDllType dll); + /** This function returns a valid handle for the main program + itself. */ + static wxDllType GetProgramHandle(void); + /** This function resolves a symbol in a loaded DLL, such as a + variable or function name. + @param dllHandle Handle of the DLL, as returned by LoadDll(). + @param name Name of the symbol. + @return A pointer to the symbol. + */ + static void * GetSymbol(wxDllType dllHandle, const wxString &name); + +private: + /// forbid construction of objects + wxDllLoader(); +}; -WX_DEFINE_ARRAY(wxClassInfo *, wxArrayClassInfo); -WX_DEFINE_ARRAY(wxClassLibInfo *, wxArrayClassLibInfo); +// ---------------------------------------------------------------------------- +// wxLibrary +// ---------------------------------------------------------------------------- -// --------------------------------------------------------------------------- -// wxClassLibrary +class wxLibrary : public wxObject +{ +public: + wxHashTable classTable; -class wxClassLibrary { -protected: - wxArrayClassLibInfo m_list; public: - wxClassLibrary(void); - ~wxClassLibrary(void); + wxLibrary(wxDllType handle); + ~wxLibrary(); - // Dynamic (un)register a (new) class in the database - void RegisterClass(wxClassInfo *class_info, const wxString& path); - void UnregisterClass(wxClassInfo *class_info); + // Get a symbol from the dynamic library + void *GetSymbol(const wxString& symbname); - // Fetch all infos whose name matches the string (wildcards allowed) - bool FetchInfos(const wxString& path, wxArrayClassLibInfo& infos); + // Create the object whose classname is "name" + wxObject *CreateObject(const wxString& name); - // Create all objects whose name matches the string (wildcards allowed) - bool CreateObjects(const wxString& path, wxArrayClassInfo& objs); +protected: + void PrepareClasses(wxClassInfo *first); - // Create one object using the EXACT name - wxObject *CreateObject(const wxString& path); + wxDllType m_handle; }; -// --------------------------------------------------------------------------- -// wxLibrary -class wxLibrary: public wxObject { -protected: - wxClassLibrary *m_liblist; - void *m_handle; -public: - wxLibrary(void *handle); - ~wxLibrary(void); - // Get a symbol from the dynamic library - void *GetSymbol(const wxString& symbname); +// ---------------------------------------------------------------------------- +// wxLibraries +// ---------------------------------------------------------------------------- - // Create the object whose classname is "name" - wxObject *CreateObject(const wxString& name); +class wxLibraries +{ +public: + wxLibraries(); + ~wxLibraries(); - wxClassLibrary *ClassLib() const; -}; + // caller is responsible for deleting the returned pointer if !NULL + wxLibrary *LoadLibrary(const wxString& basename); -// --------------------------------------------------------------------------- -// wxLibraries + wxObject *CreateObject(const wxString& name); -class wxLibraries { protected: - wxList m_loaded; -public: - wxLibraries(void); - ~wxLibraries(void); - - wxLibrary *LoadLibrary(const wxString& name); - wxObject *CreateObject(const wxString& name); + wxList m_loaded; }; -// --------------------------------------------------------------------------- +// ---------------------------------------------------------------------------- // Global variables +// ---------------------------------------------------------------------------- extern wxLibraries wxTheLibraries; -// --------------------------------------------------------------------------- +// ---------------------------------------------------------------------------- // Interesting defines +// ---------------------------------------------------------------------------- -#define WXDLL_ENTRY_FUNCTION() extern "C" wxClassLibrary *GetClassList() -#define WXDLL_EXIT_FUNCTION(param) extern "C" void FreeClassList(wxClassLibrary *param) +#define WXDLL_ENTRY_FUNCTION() \ +extern "C" wxClassInfo *wxGetClassFirst(); \ +wxClassInfo *wxGetClassFirst() { \ + return wxClassInfo::GetFirst(); \ +} -#endif +#endif // wxUSE_DYNLIB_CLASS + +#endif // _WX_DYNLIB_H__