love.filesystem (Português)

love.filesystem


Provê uma interface para o sistema de arquivos do usuário.

Este módulo provê acesso aos arquivos em dois e somente dois lugares:

  • A pasta raiz do arquivo .love (ou diretório fonte)
  • A pasta raiz do "diretório de escrita" do jogo.

A cada jogo é concedido um único diretório no sistema onde arquivos podem ser salvos, por meio do love.filesystem. Esse é o único diretório onde o love.filesystem pode salvar arquivos. Esses diretórios normalmente podem ser encontrados em algo como:

  • Windows XP: C:\Documents and Settings\user\Application Data\LOVE\ or %appdata%\LOVE\
  • Windows Vista e 7: C:\Users\user\AppData\Roaming\LOVE or %appdata%\LOVE\
  • Linux: $XDG_DATA_HOME/love/ or ~/.local/share/love/
  • Mac: /Users/user/Library/Application Support/LOVE/

Os arquivos abertos para escrita ou acréscimo sempre serão criados no diretório de escrita. O mesmo vale para outras operações que envolvam a escrita no sistema de arquivos, como o mkdir.

Arquivos abertos para leitura serão procurados no diretório de escrita e depois no arquivo .love (nessa ordem). Se um arquivo com certo nome (e caminho) existir tanto no arquivo .love quanto na pasta de escrita, aquele no diretório de escrita terá precedência.

Nota: Todos os caminhos são relativos ao arquivo .love e ao diretório de escrita. (Exceto para as chamadas de get*Directory())

É recomendado primeiro definir a identidade do seu jogo nos Arquivos de Configuração. Você também pode defini-la com love.filesystem.setIdentity().

Tipos

File (Português) Representa um arquivo no sistema de arquivos.

Funções

love.filesystem.append Acrescentar dados a um arquivo existente. Added since 0.9.0
love.filesystem.createDirectory Cria um diretório. Added since 0.9.0
love.filesystem.enumerate Retorna todos arquivos e subdiretórios no diretório. Removed in 0.9.0
love.filesystem.exists Verifica se um arquivo ou diretório existe.
love.filesystem.getAppdataDirectory Retorna diretório de dados do aplicativo (pode ser igual getUserDirectory).
love.filesystem.getDirectoryItems Retorna todos arquivos e subdiretórios no diretório. Added since 0.9.0
love.filesystem.getIdentity Obtém o diretório de escrita do seu jogo. Added since 0.9.0
love.filesystem.getLastModified Obtém a última data de modificação de um arquivo. Added since 0.7.1
love.filesystem.getSaveDirectory Obtém o caminho completo do diretório de escrita designado.
love.filesystem.getSize Obtém o tamanho de um arquivo em bytes. Added since 0.9.0
love.filesystem.getUserDirectory Retorna o caminho do diretório do usuário
love.filesystem.getWorkingDirectory Obtém o diretório de trabalho atual.
love.filesystem.init Inicializa o módulo love.filesystem, não se chama explicitamente.
love.filesystem.isDirectory Verifica se algo é um diretório.
love.filesystem.isFile Verifica se algo é um arquivo.
love.filesystem.isFused Descobre se um jogo está em modo fundido ou não. Added since 0.9.0
love.filesystem.lines Itera pelas linhas de um arquivo.
love.filesystem.load Carrega um arquivo lua (mas não executa).
love.filesystem.mkdir Cria um diretório. Removed in 0.9.0
love.filesystem.mount Monta um arquivo zip ou uma pasta no diretório de escrita do jogo para leitura. Added since 0.9.0
love.filesystem.newFile Cria um novo objeto Arquivo.
love.filesystem.newFileData Cria um novo objeto DadoDeArquivo. Added since 0.7.0
love.filesystem.read Ler o conteúdo de um arquivo
love.filesystem.remove Remove um arquivo (ou diretório).
love.filesystem.setIdentity Configura o diretório de escrita para seu jogo.
love.filesystem.setSource Configura a fonte do jogo, onde o código está.
love.filesystem.unmount Desmonta arquivo zip ou pasta montada com love.filesystem.mount. Added since 0.9.0
love.filesystem.write Escrever dados num arquivo.

Enums

FileMode (Português) Os diferentes modos em que um File pode ser aberto.

Veja Também

Outras Línguas