# 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.