include/SDL_loadso.h
author Sam Lantinga <slouken@libsdl.org>
Sat, 26 Sep 2009 23:17:08 +0000
branchSDL-1.2
changeset 4246 8b8314cc34a6
parent 4217 4c4113c2162c
child 6137 4720145f848b
permissions -rw-r--r--
Fixed bug #810

Lauri Kenttä 2009-09-26 06:42:23 PDT

Support for disabling stdio redirect with environment variables.
     1 /*
     2     SDL - Simple DirectMedia Layer
     3     Copyright (C) 1997-2009 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 /** @file SDL_loadso.h
    24  *  System dependent library loading routines
    25  */
    26 
    27 /** @file SDL_loadso.h
    28  *  Some things to keep in mind:                                        
    29  *  - These functions only work on C function names.  Other languages may
    30  *    have name mangling and intrinsic language support that varies from
    31  *    compiler to compiler.
    32  *  - Make sure you declare your function pointers with the same calling
    33  *    convention as the actual library function.  Your code will crash
    34  *    mysteriously if you do not do this.
    35  *  - Avoid namespace collisions.  If you load a symbol from the library,
    36  *    it is not defined whether or not it goes into the global symbol
    37  *    namespace for the application.  If it does and it conflicts with
    38  *    symbols in your code or other shared libraries, you will not get
    39  *    the results you expect. :)
    40  */
    41 
    42 
    43 #ifndef _SDL_loadso_h
    44 #define _SDL_loadso_h
    45 
    46 #include "SDL_stdinc.h"
    47 #include "SDL_error.h"
    48 
    49 #include "begin_code.h"
    50 /* Set up for C function definitions, even when using C++ */
    51 #ifdef __cplusplus
    52 extern "C" {
    53 #endif
    54 
    55 /**
    56  * This function dynamically loads a shared object and returns a pointer
    57  * to the object handle (or NULL if there was an error).
    58  * The 'sofile' parameter is a system dependent name of the object file.
    59  */
    60 extern DECLSPEC void * SDLCALL SDL_LoadObject(const char *sofile);
    61 
    62 /**
    63  * Given an object handle, this function looks up the address of the
    64  * named function in the shared object and returns it.  This address
    65  * is no longer valid after calling SDL_UnloadObject().
    66  */
    67 extern DECLSPEC void * SDLCALL SDL_LoadFunction(void *handle, const char *name);
    68 
    69 /** Unload a shared object from memory */
    70 extern DECLSPEC void SDLCALL SDL_UnloadObject(void *handle);
    71 
    72 /* Ends C function definitions when using C++ */
    73 #ifdef __cplusplus
    74 }
    75 #endif
    76 #include "close_code.h"
    77 
    78 #endif /* _SDL_loadso_h */