View source for PT-BR/fileCopy

{{BR/Funcao compartilhada}}
__NOTOC__
Esta função copia um arquivo.
{{BR/Nota|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as [[Shared_Scripting_Functions#XML_functions|funções XML]].}}
{{BR/Tip|Se você não quiser compartilhar o conteúdo do arquivo criado com outros servidores, nomeie o caminho do arquivo com '''@''' no início. Veja a página [[filepath]] para entender melhor.}}

==Sintaxe==
<syntaxhighlight lang="lua">
bool fileCopy ( string filePath, string copyToFilePath [, bool overwrite = false ] )
</syntaxhighlight>
{{PT-BR/POO|Esta é uma função estática abaixo da classe File.|[[File]].copy}}

===Argumentos necessários===
* '''filePath''': O caminho do arquivo que você quer copiar.
* '''copyToFilePath''': Para onde o arquivo copiado deve ir.

===Argumentos opcionais===
* '''overwrite''': Se definido para '''true''' esta operação vai sobrescrever o arquivo que já existir no caminho especificado em ''copyToFilePath''.

==Retorno==
Retorna '''true''' se o arquivo foi copiado com sucesso, do caso contrário retorna '''false''' se o ''filePath'' não existir.

==Exemplo==
<section name="Lado server" class="server" show="true">
Este exemplo copia um arquivo chamado 'test.txt' e o chama de 'test1.txt'.
<syntaxhighlight lang="lua">
addEventHandler("onResourceStart", resourceRoot, function(res)
    local filePath = ":"..getResourceName(res).."/test.txt"
    fileCreate(filePath) --cria o arquivo no resource o nomeia como 'test.txt'.
    if fileCopy(filePath, ":"..getResourceName(res).."/test1.txt") then
         outputChatBox("File was successfully copied!", root, 0, 100, 0)
    else
         outputChatBox("File was not successfully copied, probably because it doesn't exist.", root, 100, 0, 0)
    end
end)
</syntaxhighlight>
</section>
<section name="Lado client" class="client" show="true">
Este exemplo copia um arquivo chamado 'test.txt' e o chama de 'test1.txt'.
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", resourceRoot, function(res)
    local filePath = ":"..getResourceName(res).."/test.txt"
    fileCreate(filePath) --cria o arquivo no resource o nomeia como 'test.txt'.
    if fileCopy(filePath,":"..getResourceName(res).."/test1.txt") then
         outputChatBox("File was successfully copied!", 0, 100, 0)
    else
        outputChatBox("File was not successfully copied, probably because it doesn't exist.", 100, 0, 0)
    end
end)
</syntaxhighlight>
</section>


{{Requirements|1.3.1|1.3.1}}

==Veja também==
{{PT-BR/File functions}}