SDL_RenamePath - Rename a file or directory.
Contents
Availability
This function is available since SDL 3.2.0.
Simple Directmedia Layer SDL 3.2.20 SDL_RenamePath(3)
Description
If the file at newpath already exists, it will replaced.
Note that this will not copy files across filesystems/drives/volumes, as that is a much more complicated
(and possibly time-consuming) operation.
Which is to say, if this function fails, SDL_CopyFile() to a temporary file in the same directory as
newpath, then SDL_RenamePath() from the temporary file to newpath and SDL_RemovePath() on oldpath might
work for files. Renaming a non-empty directory across filesystems is dramatically more complex, however.
Function Parameters
oldpath
the old path.
newpath
the new path.
Name
SDL_RenamePath - Rename a file or directory.
Return Value
for more information.
Synopsis
#include<SDL3/SDL_filesystem.h>boolSDL_RenamePath(constchar*oldpath,constchar*newpath);
