Files
tubestation/docs/nspr/reference/pr_getnameforidentity.rst
2022-02-02 17:19:51 +00:00

42 lines
738 B
ReStructuredText

PR_GetNameForIdentity
=====================
Gets the string associated with a layer's unique identity.
Syntax
------
.. code:: eval
#include <prio.h>
const char* PR_GetNameForIdentity(PRDescIdentity ident);
Parameter
~~~~~~~~~
The function has the following parameter:
``ident``
A layer's identity.
Returns
~~~~~~~
The function returns one of the following values:
- If successful, the function returns a pointer to the string
associated with the specified layer.
- If unsuccessful, the function returns ``NULL``.
Description
-----------
A string may be associated with a layer when the layer is created. The
string is copied by the runtime, and :ref:`PR_GetNameForIdentity` returns a
pointer to that copy.