# fileCopy (Compartilhado)

> Copia um arquivo, que pode ser de outro recurso, para o recurso que chama. As pastas que faltam no destino são criadas.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Arquivos
- **URL**: https://wiki.mymp.gg/pt/fileCopy

## Sintaxe

```lua
bool fileCopy(string from, string to [, bool overwrite = false])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `from` | `string` | O arquivo a copiar. Um caminho dentro do recurso que chama, ou `@recurso/caminho` para um arquivo de outro recurso. |
| `to` | `string` | Para onde copiar. Um caminho dentro do recurso que chama. |
| `overwrite` | `bool` | Se um arquivo que já existe no destino é substituído. *(padrão: `false`)* |

## Retorno

`true` se deu certo; `false` se a origem não é um arquivo ou o destino já existe sem `overwrite`.

Um caminho não pode ter `..`, `\`, `:` nem começar com `/`. Os arquivos de outro recurso só podem ser lidos; um caminho inválido gera um aviso e a função devolve `false`.

## Exemplo

```lua
fileCopy("@defaults/settings.json", "settings.json")
```

## Veja também

- [fileRename (Compartilhado)](https://wiki.mymp.gg/pt/fileRename.md): Renomeia ou move um arquivo dentro do recurso que chama. As pastas que faltam no destino são criadas.
- [fileDelete (Compartilhado)](https://wiki.mymp.gg/pt/fileDelete.md): Apaga um arquivo do recurso que chama.