]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | SDL - Simple DirectMedia Layer | |
3 | Copyright (C) 1997-2006 Sam Lantinga | |
4 | ||
5 | This library is free software; you can redistribute it and/or | |
6 | modify it under the terms of the GNU Lesser General Public | |
7 | License as published by the Free Software Foundation; either | |
8 | version 2.1 of the License, or (at your option) any later version. | |
9 | ||
10 | This library is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 | Lesser General Public License for more details. | |
14 | ||
15 | You should have received a copy of the GNU Lesser General Public | |
16 | License along with this library; if not, write to the Free Software | |
17 | Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
18 | ||
19 | Sam Lantinga | |
20 | slouken@libsdl.org | |
21 | */ | |
22 | ||
23 | /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ | |
24 | /* System dependent library loading routines */ | |
25 | ||
26 | /* Some things to keep in mind: | |
27 | - These functions only work on C function names. Other languages may | |
28 | have name mangling and intrinsic language support that varies from | |
29 | compiler to compiler. | |
30 | - Make sure you declare your function pointers with the same calling | |
31 | convention as the actual library function. Your code will crash | |
32 | mysteriously if you do not do this. | |
33 | - Avoid namespace collisions. If you load a symbol from the library, | |
34 | it is not defined whether or not it goes into the global symbol | |
35 | namespace for the application. If it does and it conflicts with | |
36 | symbols in your code or other shared libraries, you will not get | |
37 | the results you expect. :) | |
38 | */ | |
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 | /* This function dynamically loads a shared object and returns a pointer | |
54 | * to the object handle (or NULL if there was an error). | |
55 | * The 'sofile' parameter is a system dependent name of the object file. | |
56 | */ | |
57 | extern DECLSPEC void * SDLCALL SDL_LoadObject(const char *sofile); | |
58 | ||
59 | /* Given an object handle, this function looks up the address of the | |
60 | * named function in the shared object and returns it. This address | |
61 | * is no longer valid after calling SDL_UnloadObject(). | |
62 | */ | |
63 | extern DECLSPEC void * SDLCALL SDL_LoadFunction(void *handle, const char *name); | |
64 | ||
65 | /* Unload a shared object from memory */ | |
66 | extern DECLSPEC void SDLCALL SDL_UnloadObject(void *handle); | |
67 | ||
68 | /* Ends C function definitions when using C++ */ | |
69 | #ifdef __cplusplus | |
70 | } | |
71 | #endif | |
72 | #include "close_code.h" | |
73 | ||
74 | #endif /* _SDL_loadso_h */ |