Функция _FO_FileDirReName

         Описание функции


_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)