PT-BR/fileCopy

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Esta função copia um arquivo.

Post-it.png Nota: As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as funções XML.
Tip-ptbr.png Dica: 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

bool fileCopy ( string filePath, string copyToFilePath [, bool overwrite = false ] )

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

Nota: Esta é uma função estática abaixo da classe File.
Método: 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

Click to collapse [-]
Lado server

Este exemplo copia um arquivo chamado 'test.txt' e o chama de 'test1.txt'.

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)
Click to collapse [-]
Lado client

Este exemplo copia um arquivo chamado 'test.txt' e o chama de 'test1.txt'.

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)


Minimum server version 1.3.1
Minimum client version 1.3.1

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.3.1" client="1.3.1" />

Veja também