Описание функции Описание функции
_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)