Source code
Revision control
Copy as Markdown
Other Tools
PR_LoadLibrary
==============
Loads a referenced library.
Syntax
------
.. code::
#include <prlink.h>
PRLibrary* PR_LoadLibrary(const char *name);
Parameters
~~~~~~~~~~
The function has this parameter:
``name``
A platform-dependent character array that names the library to be
loaded, as returned by :ref:`PR_GetLibraryName`.
Returns
~~~~~~~
If successful, returns a reference to an opaque :ref:`PRLibrary` object.
If the operation fails, returns ``NULL``. Use :ref:`PR_GetError` to find
the reason for the failure.
Description
-----------
This function loads and returns a reference to the specified library.
The returned reference becomes the library's identity. The function
suppresses duplicate loading if the library is already known by the
runtime.
Each call to :ref:`PR_LoadLibrary` must be paired with a corresponding call
to :ref:`PR_UnloadLibrary` in order to return the runtime to its original
state.