]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | Simple DirectMedia Layer | |
3 | Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org> | |
4 | ||
5 | This software is provided 'as-is', without any express or implied | |
6 | warranty. In no event will the authors be held liable for any damages | |
7 | arising from the use of this software. | |
8 | ||
9 | Permission is granted to anyone to use this software for any purpose, | |
10 | including commercial applications, and to alter it and redistribute it | |
11 | freely, subject to the following restrictions: | |
12 | ||
13 | 1. The origin of this software must not be misrepresented; you must not | |
14 | claim that you wrote the original software. If you use this software | |
15 | in a product, an acknowledgment in the product documentation would be | |
16 | appreciated but is not required. | |
17 | 2. Altered source versions must be plainly marked as such, and must not be | |
18 | misrepresented as being the original software. | |
19 | 3. This notice may not be removed or altered from any source distribution. | |
20 | */ | |
21 | ||
22 | /** | |
23 | * \file SDL_loadso.h | |
24 | * | |
25 | * System dependent library loading routines | |
26 | * | |
27 | * Some things to keep in mind: | |
28 | * \li These functions only work on C function names. Other languages may | |
29 | * have name mangling and intrinsic language support that varies from | |
30 | * compiler to compiler. | |
31 | * \li Make sure you declare your function pointers with the same calling | |
32 | * convention as the actual library function. Your code will crash | |
33 | * mysteriously if you do not do this. | |
34 | * \li Avoid namespace collisions. If you load a symbol from the library, | |
35 | * it is not defined whether or not it goes into the global symbol | |
36 | * namespace for the application. If it does and it conflicts with | |
37 | * symbols in your code or other shared libraries, you will not get | |
38 | * the results you expect. :) | |
39 | */ | |
40 | ||
41 | #ifndef _SDL_loadso_h | |
42 | #define _SDL_loadso_h | |
43 | ||
44 | #include "SDL_stdinc.h" | |
45 | #include "SDL_error.h" | |
46 | ||
47 | #include "begin_code.h" | |
48 | /* Set up for C function definitions, even when using C++ */ | |
49 | #ifdef __cplusplus | |
50 | extern "C" { | |
51 | #endif | |
52 | ||
53 | /** | |
54 | * This function dynamically loads a shared object and returns a pointer | |
55 | * to the object handle (or NULL if there was an error). | |
56 | * The 'sofile' parameter is a system dependent name of the object file. | |
57 | */ | |
58 | extern DECLSPEC void *SDLCALL SDL_LoadObject(const char *sofile); | |
59 | ||
60 | /** | |
61 | * Given an object handle, this function looks up the address of the | |
62 | * named function in the shared object and returns it. This address | |
63 | * is no longer valid after calling SDL_UnloadObject(). | |
64 | */ | |
65 | extern DECLSPEC void *SDLCALL SDL_LoadFunction(void *handle, | |
66 | const char *name); | |
67 | ||
68 | /** | |
69 | * Unload a shared object from memory. | |
70 | */ | |
71 | extern DECLSPEC void SDLCALL SDL_UnloadObject(void *handle); | |
72 | ||
73 | /* Ends C function definitions when using C++ */ | |
74 | #ifdef __cplusplus | |
75 | } | |
76 | #endif | |
77 | #include "close_code.h" | |
78 | ||
79 | #endif /* _SDL_loadso_h */ | |
80 | ||
81 | /* vi: set ts=4 sw=4 expandtab: */ |