Shared Libraries
[Platform Abstraction]


Typedefs

typedef void * SharedLibrary
 A handle to a shared library object.


Functions

SharedLibrary openLibrary (const Char *libraryName)
void closeLibrary (SharedLibrary library)
bool bindSymbol (void **ptr, SharedLibrary library, const Char *symbol)
void normalizeLinkerBehavior (char *argv[])

Function Documentation

bool bindSymbol (  void **    ptr,
SharedLibrary    library,
const Char *    symbol
) 
 

Bind a pointer to a library entry point.

Parameters:
ptr  returns a pointer to the library entry point
library  a library handle from openLibrary()
symbol  the name of the entry point
Returns:
True if successful, false if the entry point does not exist.

void closeLibrary (  SharedLibrary    library ) 
 

Unload a shared library. All bound pointers will become invalid.

void normalizeLinkerBehavior (  char *    argv[] ) 
 

Standardize the behavior of the library loader across platforms. Under Win32, the directory containing the application executable is considered part of the search path. This routine makes the POSIX platforms behave the same way. Note that this function may restart the program, which it must do to make the new search path take effect.

SharedLibrary openLibrary (  const Char *    libraryName ) 
 

Load a shared library. The name given by libraryName should exclude any system dependent prefix or extension, as these will be added by the function itself. For example, the call openLibrary("Bin/Mylib") will load the library "Bin/Mylib.dll" on Win32 systems, and "Bin/libMylib.so" on POSIX systems.

Returns:
A library handle if successful, or zero if the library could not be loaded.

Flat Four Engine
Copyright (C) 2001 by 379, Inc. 		This page generated by Doxygen