PT-BR/fileRename

Renomeia o arquivo que especificar.

	Nota: Com esta função você também pode mover determinado arquivo para um lugar diferente, seja uma pasta diferente no resource atual ou até mesmo para a pasta de um outro resource. Mas para fazer isso o resource deve ter a seguinte permissão da ACL definida para true: 'ModifyOtherObjects'.

Sintaxe

bool fileRename ( string filePath, string newFilePath )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Nota: Esta é uma função estática abaixo da classe File.

Método: File.rename(...)

Argumentos necessários

filePath: O caminho do arquivo a ser criado seguindo o seguinte formato: ":resourceName/path". resourceName é o nome do resource do arquivo que vai estar lá, e path é o caminho do arquivo relativo ao diretório do resource.
newFilePath: O caminho de destino para o arquivo especificado no mesmo formato.

Retorno

Se renomeado com sucesso, retorna true. Caso contrário retorna false.

Exemplo

Este exemplo renomeia o arquivo test1.txt que está na raiz do resource atual, para test2.txt.

if fileRename( "test1.txt", "test2.txt" ) then
    outputConsole("File `test1.txt` successfully renamed to `test2.txt`")
else
    outputConsole("Unable to rename `test1.txt`")
end

Este exemplo move o arquivo test1.txt que está na raiz do resource atual para a pasta myFolder. Se esta pasta não existir, será criada antes desse arquivo ser movido para lá.

if fileRename( "test1.txt", "myFolder/test1.txt" ) then
    outputConsole("File `test1.txt` successfuly moved to `myFolder` folder")
else
    outputConsole("Unable to move `test1.txt`")
end

Veja também

BETA: DA VERSÃO 1.6.0 r21938 ADIANTE

fileGetContents