SDL Library

Dependents:   H261_decoder

Embed: (wiki syntax)

« Back to documentation index

SDL_loadso.h File Reference

SDL_loadso.h File Reference

System dependent library loading routines. More...

Go to the source code of this file.

Functions

DECLSPEC void *SDLCALL SDL_LoadObject (const char *sofile)
 This function dynamically loads a shared object and returns a pointer to the object handle (or NULL if there was an error).
DECLSPEC void *SDLCALL SDL_LoadFunction (void *handle, const char *name)
 Given an object handle, this function looks up the address of the named function in the shared object and returns it.
DECLSPEC void SDLCALL SDL_UnloadObject (void *handle)
 Unload a shared object from memory.

Detailed Description

System dependent library loading routines.

Some things to keep in mind:

  • These functions only work on C function names. Other languages may have name mangling and intrinsic language support that varies from compiler to compiler.
  • Make sure you declare your function pointers with the same calling convention as the actual library function. Your code will crash mysteriously if you do not do this.
  • Avoid namespace collisions. If you load a symbol from the library, it is not defined whether or not it goes into the global symbol namespace for the application. If it does and it conflicts with symbols in your code or other shared libraries, you will not get the results you expect. :)

Definition in file SDL_loadso.h.


Function Documentation

DECLSPEC void* SDLCALL SDL_LoadFunction ( void *  handle,
const char *  name 
)

Given an object handle, this function looks up the address of the named function in the shared object and returns it.

This address is no longer valid after calling SDL_UnloadObject().

DECLSPEC void* SDLCALL SDL_LoadObject ( const char *  sofile )

This function dynamically loads a shared object and returns a pointer to the object handle (or NULL if there was an error).

The 'sofile' parameter is a system dependent name of the object file.

DECLSPEC void SDLCALL SDL_UnloadObject ( void *  handle )

Unload a shared object from memory.