Sirikata
|
00001 /* Sirikata Utilities -- Dynamic Library Loading 00002 * DynamicLibrary.hpp 00003 * 00004 * Copyright (c) 2009, Ewen Cheslack-Postava 00005 * All rights reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions are 00009 * met: 00010 * * Redistributions of source code must retain the above copyright 00011 * notice, this list of conditions and the following disclaimer. 00012 * * Redistributions in binary form must reproduce the above copyright 00013 * notice, this list of conditions and the following disclaimer in 00014 * the documentation and/or other materials provided with the 00015 * distribution. 00016 * * Neither the name of Sirikata nor the names of its contributors may 00017 * be used to endorse or promote products derived from this software 00018 * without specific prior written permission. 00019 * 00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS 00021 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 00022 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 00023 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 00024 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 00025 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 00026 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 00027 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 00028 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 00029 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 00030 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00031 */ 00032 00033 #ifndef _SIRIKATA_DYNAMIC_LIBRARY_HPP_ 00034 #define _SIRIKATA_DYNAMIC_LIBRARY_HPP_ 00035 00036 #include <sirikata/core/util/Platform.hpp> 00037 00038 #if SIRIKATA_PLATFORM == SIRIKATA_PLATFORM_WINDOWS 00039 struct HINSTANCE__; 00040 # define DL_HANDLE struct HINSTANCE__* 00041 #elif SIRIKATA_PLATFORM == SIRIKATA_PLATFORM_MAC || SIRIKATA_PLATFORM == SIRIKATA_PLATFORM_LINUX 00042 # define DL_HANDLE void* 00043 #endif 00044 00045 namespace Sirikata { 00046 00051 class SIRIKATA_EXPORT DynamicLibrary { 00052 public: 00053 // Helper to initialize loading of dynamic libraries. Certain 00054 // platform-specific initialization that is common occurs here. 00055 static void Initialize(); 00056 // Helper for adding locations to load from 00057 static void AddLoadPath(const String& path); 00058 00059 DynamicLibrary(const String& path); 00060 ~DynamicLibrary(); 00061 00062 bool load(); 00063 bool unload(); 00064 00065 void* symbol(const String& name) const; 00066 00068 static String prefix(); 00070 static String postfix(); 00072 static String extension(); 00076 static String filename(const String& path, const String& name); 00080 static String filename(const String& name); 00085 static void gc(DL_HANDLE handle=NULL); 00086 private: 00090 bool isValidLibraryFilename() const; 00091 00092 String mPath; 00093 DL_HANDLE mHandle; 00094 }; // class DynamicLibrary 00095 00096 } // namespace Sirikata 00097 00098 #endif //_SIRIKATA_DYNAMIC_LIBRARY_HPP_