RenameFile()

Синтаксис

Result = RenameFile(OldFilename$ , NewFilename$)

Описание

Переименовывает или перемещает файл или каталог (директорию).

Параметры

OldFilename$	Старое имя (включая путь) файла/каталога.
NewFilename$	Новое имя (включая путь) файла/каталога.

Возвращаемое значение

Возвращает не нулевое значение, если операция прошла успешно и ноль, если она не удалась.

Комментарии

Старое и новое имя файла не обязательно должны находиться в одном каталоге, поэтому эту функцию можно использовать для перемещения файла в другой каталог.
При этом, если целевой файл уже существует, ни чего не происходит, функция возвращает ноль. При перемещении атрибуты файла исходника игнорируются, он удаляется без предупреждения.
Эта функция также может использоваться для переименования / перемещения каталогов, с теми же условиями.

Пример

RenameFile("C:\Temp\Test.txt", "C:\Temp\TestNew.txt") ; Переименовать файл Test.txt в каталоге Temp
RenameFile("C:\Temp\", "C:\TempNew\") ; Переименовать каталог Temp в TempNew

If RenameFile("C:\test.txt", "D:\temp\test_backup.txt")
    Debug "Перемещение и переименование успешно."      ; Перемещение и переименование файла прошло успешно
Else
    Debug "Не удалось переместить или переименовать."  ; Не удалось переместить/переименовать, например из-за отсутствия исходного файла
EndIf

См. также

CopyFile(), DeleteFile(), CreateFile(), CopyDirectory()

Поддерживаемые OS

Все