CKTIS / C++
std::filesystem::rename: alterar nome ou localização
std::filesystem::rename move uma entrada de old_p para new_p com semântica de rename POSIX, sem copiar o conteúdo.
Versão: C++23
Sintaxe
void std::filesystem::rename(
const std::filesystem::path& old_p,
const std::filesystem::path& new_p);
void std::filesystem::rename(
const std::filesystem::path& old_p,
const std::filesystem::path& new_p, std::error_code& ec) noexcept;std::filesystem::rename(old_p, new_p) de <filesystem> altera o nome ou localização de um objeto e devolve void. Se os dois caminhos resolverem para o mesmo ficheiro existente, nada faz; move um link simbólico como entrada, sem seguir o destino.
O exemplo cria old.txt, muda o nome para new.txt, verifica os dois caminhos e lê o conteúdo. 1 1 data confirma a ausência do nome antigo, a presença do novo e a preservação dos dados.
Um ficheiro de destino existente que não seja diretório pode ser substituído. Substituir um diretório vazio funciona em POSIX, mas pode falhar noutros sistemas; mover entre sistemas de ficheiros também pode falhar. A forma que lança comunica filesystem_error; a forma error_code& é noexcept e define ec.
Exemplos
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-rename";
const fs::path old_path = root / "old.txt";
const fs::path new_path = root / "new.txt";
std::error_code ignored;
fs::remove_all(root, ignored);
fs::create_directory(root);
std::ofstream(old_path) << "data";
fs::rename(old_path, new_path);
std::ifstream input(new_path);
std::string text;
input >> text;
input.close();
std::cout << !fs::exists(old_path) << ' ' << fs::exists(new_path) << ' ' << text << '\n';
fs::remove_all(root, ignored);
}
Resultado
1 1 data
std::filesystem::rename → 1 1 data