std:: rename
|
Определено в заголовочном файле
<cstdio>
|
||
|
int
rename
(
const
char
*
old_filename,
const
char
*
new_filename
)
;
|
||
Изменяет имя файла. Файл идентифицируется строкой символов, на которую указывает old_filename . Новое имя файла идентифицируется строкой символов, на которую указывает new_filename .
Если new_filename существует, поведение определяется реализацией.
Содержание |
Параметры
| old_filename | - | указатель на строку, завершающуюся нулевым символом, содержащую путь к переименовываемому файлу |
| new_filename | - | указатель на строку, завершающуюся нулевым символом, содержащую новый путь к файлу |
Возвращаемое значение
0 при успешном выполнении или ненулевое значение при ошибке.
Примечания
POSIX определяет множество дополнительных деталей о семантике этой функции, которые воспроизводятся в C++ с помощью std::filesystem::rename .
Пример
#include <cstdio> #include <cstdlib> #include <fstream> #include <iostream> int main() { if (!std::ofstream("from.txt").put('a')) // создание и запись в файл { std::perror("Error creating from.txt"); return EXIT_FAILURE; } if (std::rename("from.txt", "to.txt")) { std::perror("Error renaming"); return EXIT_FAILURE; } std::cout << std::ifstream("to.txt").rdbuf() << '\n'; // вывод содержимого файла return EXIT_SUCCESS; }
Вывод:
a
Смотрите также
|
(C++17)
|
перемещает или переименовывает файл или директорию
(функция) |
|
удаляет файл
(функция) |
|
|
Документация C
для
rename
|
|