SD.h: rename File and/or copy File

[dsyleixa]

Related area

SD.h

Hardware specification

for either ESP32 plus SD slot

Is your feature request related to a problem?

I am missing a certain SD card <SD.h> functionality

Describe the solution you'd like

similar to
#include <SD.h>
File myFile;
SD.remove("example.txt");

now additionally:

int SD.rename("example.txt", "newname.txt");
and
int SD.copy("example.txt", "newname.txt");

Return value
If the file is successfully renamed or copied, a zero value is returned.
On failure, a nonzero value has to be returned.
Perhaps, an errno variable is also set to a system-specific error code on failure.

Describe alternatives you've considered

nothing similar found

Additional context

No response

[P-R-O-C-H-Y]

@dsyleixa Just looking now into this and the rename function already exists.

    bool rename(const char* pathFrom, const char* pathTo);
    bool rename(const String& pathFrom, const String& pathTo);

It's even used in our examples for SD cards. If that works correctly I think there is no need to implement copy file as renaming will do it. I am closing this feature request, but feel free to reopen it if needed.

[dsyleixa]

no, rename does not create a 2nd file additionally, it just renames the 1 and only existing one.
So the copy command still needs to be impemented.

[me-no-dev]

@dsyleixa copy is not part of Arduino SD/FS API. The reason is that there are different types of copy and is not necessary that the destination is on the same volume/filesystem as the source, so you should copy the data yourself. Just open the source for reading, the destination for writing and manually read/write from one to the other.