File: SharedLib.h

package info (click to toggle)
spring 0.81.2.1%2Bdfsg1-6
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 28,496 kB
  • ctags: 37,096
  • sloc: cpp: 238,659; ansic: 13,784; java: 12,175; awk: 3,428; python: 1,159; xml: 738; perl: 405; sh: 297; makefile: 267; pascal: 228; objc: 192
file content (72 lines) | stat: -rw-r--r-- 1,671 bytes parent folder | download
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
/**
 * @file SharedLib.h
 * @brief shared library loader
 * @author Christopher Han <xiphux@gmail.com>
 * @author Robin Vobruba <hoijui.quaero@gmail.com>
 *
 * Base shared library loading class definitiion
 * Copyright (C) 2005.  Licensed under the terms of the
 * GNU GPL, v2 or later.
 */
#ifndef SHAREDLIB_H
#define SHAREDLIB_H

#include <string>

/**
 * @brief shared library base
 *
 * This is the abstract shared library class used for
 * polymorphic loading.  Platform-specifics should
 * derive from this.
 */
class SharedLib
{
public:
	/**
	 * @brief instantiate
	 * @param fileName file name as a C string
	 * @return platform-specific shared library class
	 */
	static SharedLib* Instantiate(const char* fileName);

	/**
	 * @brief instantiate
	 * @param fileName file name as a C++ string
	 * @return platform-specific shared library class
	 */
	static SharedLib* Instantiate(const std::string& fileName);

	/**
	 * Explicitly unload this shared library
	 * @brief unload
	 */
	virtual void Unload() = 0;

	/**
	 * Returns true if loading of the native library failed.
	 * @brief loadFailed
	 */
	virtual bool LoadFailed() = 0;

	/**
	 * @brief GetLibExtension
	 * @return "dll", "dylib" or "so" depending on OS
	 */
	static const char* GetLibExtension();

	/**
	 * @brief Find Address
	 * @param symbol function name (symbol) to locate
	 *
	 * Abstract so it must be implemented specifically by all platforms.
	 */
	virtual void* FindAddress(const char* symbol) = 0;

	virtual ~SharedLib();

protected:
	static void reportError(const char* errorMsg, const char* fileName = "???", int lineNumber = -1, const char* function = "???");
};

#endif // SHAREDLIB_H