_FO_FileDirReName
Переименовывает файл или каталог.
#Include <FileOperations.au3>
_FO_FileDirReName ( $sSource, $sNewName [, $iFlag=0 [, $DelAttrib=0 [, $iDir=-1]]] )
Параметры
$sSource | Полный путь к каталогу или файлу |
$sNewName |
Новое имя |
$iFlag |
[необязательный] Флаг перезаписи существующих 0 - (по умолчанию) не перезаписывать существующий файл/каталог 1 - перезаписывать существующий файл (если каталог, то предварительное его удаление) |
$DelAttrib |
[необязательный] Снять атрибуты (-RST) непозволяющие удалить файл/каталог 0 - (по умолчанию) не снимать атрибуты 1 - снимать атрибуты |
$iDir |
[необязательный] Указывает чем является $sSource -1 - (по умолчанию) автоопределение 0 - файл 1 - каталог |
Возвращаемое значение
Успех: | Возвращает 1. |
Ошибка: | Возвращает 0 и устанавливает @error: |
@error: | 0 - нет ошибок |
1 - FileMove или DirMove возвратили неудачу | |
2 - $sNewName - пустая строка | |
3 - $sSource - файл/каталог по указанному пути не существует | |
4 - исходное и новое имя совпадают | |
5 - $sNewName - содержит недопустимые символы |
Примечания
При использовании $iFlag = 1, если новый файл/каталог с таким же именем существует, то будет удалён, т.е. не будет слияние каталогов. Функция позволяет переименовать с изменением регистра.Пример
; AZJIO
; http://www.autoitscript.com/forum/topic/133224-filesearch-foldersearch/
#include <FileOperations.au3>
_FO_FileDirReName('C:\file.txt', 'Новое_Имя.txt')
MsgBox(0, 'Сообщение', '@error = ' & @error)