# fileGetContents (Compartilhado)

> Lê um arquivo inteiro de uma vez, sem abri-lo.

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

## Sintaxe

```lua
string|false fileGetContents(string path)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `path` | `string` | Um caminho dentro do recurso que chama, ou `@recurso/caminho` para um arquivo de outro recurso. |

## Retorno

O conteúdo, ou `false` se o arquivo não existe, é uma pasta ou não pôde ser lido.

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
local text = fileGetContents("config.json")
local config = text and fromJSON(text) or {}
```

## Veja também

- [fileOpen (Compartilhado)](https://wiki.mymp.gg/pt/fileOpen.md): Abre um arquivo que já existe, com a posição no começo.
- [fileRead (Compartilhado)](https://wiki.mymp.gg/pt/fileRead.md): Lê bytes de um arquivo a partir da posição atual e avança a posição.
- [fromJSON (Compartilhado)](https://wiki.mymp.gg/pt/fromJSON.md): Converte texto JSON num valor Lua. É a mesma função que json.decode.