53 lines
1.2 KiB
ReStructuredText
53 lines
1.2 KiB
ReStructuredText
PR_GetLibraryName
|
|
=================
|
|
|
|
Constructs a full library path name.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prlink.h>
|
|
|
|
char* PR_GetLibraryName (
|
|
const char *dir,
|
|
const char *lib);
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
The function has these parameters:
|
|
|
|
``dir``
|
|
A ``NULL``-terminated string representing the path name of the
|
|
library, as returned by :ref:`PR_GetLibraryPath`.
|
|
``lib``
|
|
The leaf name of the library of interest.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
If successful, returns a new character string containing a constructed
|
|
path name. In case of error, returns ``NULL``.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
This function constructs a full path name from the specified directory
|
|
name and library name. The constructed path name refers to the actual
|
|
dynamically loaded library. It is suitable for use in the
|
|
:ref:`PR_LoadLibrary` call.
|
|
|
|
This function does not test for existence of the specified file, it just
|
|
constructs the full filename. The way the name is constructed is system
|
|
dependent.
|
|
|
|
If sufficient storage cannot be allocated to contain the constructed
|
|
path name, the function returns ``NULL``. Storage for the result is
|
|
allocated by the runtime and becomes the responsibility of the caller.
|
|
When it is no longer used, free it using :ref:`PR_FreeLibraryName`.
|