rename - cppreference.com (original) (raw)

| | | | | --------------------------------------------------------------------- | | | | int rename( const char* old_filename, const char* new_filename ); | | |

Changes the filename of a file. The file is identified by character string pointed to by old_filename. The new filename is identified by character string pointed to by new_filename.

If new_filename exists, the behavior is implementation-defined.

[edit] Parameters

old_filename	-	pointer to a null-terminated string containing the path identifying the file to rename
new_filename	-	pointer to a null-terminated string containing the new path of the file

[edit] Return value

0 upon success or non-zero value on error.

[edit] Notes

POSIX specifies many additional details on the semantics of this function.

[edit] Example

[edit] References