45 lines
767 B
ReStructuredText
45 lines
767 B
ReStructuredText
PR_Rename
|
|
=========
|
|
|
|
Renames a file.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prio.h>
|
|
|
|
PRStatus PR_Rename(
|
|
const char *from,
|
|
const char *to);
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
The function has the following parameters:
|
|
|
|
``from``
|
|
The old name of the file to be renamed.
|
|
``to``
|
|
The new name of the file.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
One of the following values:
|
|
|
|
- If file is successfully renamed, ``PR_SUCCESS``.
|
|
- If file is not successfully renamed, ``PR_FAILURE``.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
:ref:`PR_Rename` renames a file from its old name (``from``) to a new name
|
|
(``to``). If a file with the new name already exists, :ref:`PR_Rename`
|
|
fails with the error code ``PR_FILE_EXISTS_ERROR``. In this case,
|
|
:ref:`PR_Rename` does not overwrite the existing filename.
|