std:: rename
| I/O manipulators | ||||
| Print functions (C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
|
(C++23)
|
||||
|
(
C++98/26*
)
|
||||
|
(C++20)
|
||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(
C++98/26*
)
|
||||
|
(
C++98/26*
)
|
||||
|
(
C++98/26*
)
|
||||
| Synchronized Output | ||||
|
(C++20)
|
||||
| Types | ||||
| Error category interface | ||||
|
(C++11)
|
||||
|
(C++11)
|
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Определено в заголовочном файле
<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
|
|