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.	0.9.0
love.filesystem.createDirectory	Cria um diretório.	0.9.0
love.filesystem.enumerate	Retorna todos arquivos e subdiretórios no diretório.		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.	0.9.0
love.filesystem.getIdentity	Obtém o diretório de escrita do seu jogo.	0.9.0
love.filesystem.getLastModified	Obtém a última data de modificação de um arquivo.	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.	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.	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.		0.9.0
love.filesystem.mount	Monta um arquivo zip ou uma pasta no diretório de escrita do jogo para leitura.	0.9.0
love.filesystem.newFile	Cria um novo objeto Arquivo.
love.filesystem.newFileData	Cria um novo objeto DadoDeArquivo.	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.	0.9.0
love.filesystem.write	Escrever dados num arquivo.