Difference between revisions of "love.filesystem (Português)"

m (atualização na lista de funções)
(translation update)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
Provê uma interface para o sistema de arquivos do usuário.
+
<span style="color: #597E9A; font-size: 18pt">love.filesystem</span>
 +
{{#set:RealLink=love.filesystem (Português)}}
 +
{{#set:DisplayName=love.filesystem}}
 +
Provê uma interface para o sistema de arquivos do usuário.  
  
Este módulo provê acesso aos Arquivos de dois e somente dois lugares:
+
Este módulo provê acesso aos arquivos em dois e somente dois lugares:  
  
*  A pasta raiz do .love-file. (Alternativamente ao diretório.)
+
*  A pasta raiz do arquivo .love (ou diretório fonte)
*  A pasta raiz do diretório de escrita.
+
*  A pasta raiz do "diretório de escrita" do jogo.
  
Cada jogo é concedido um único diretório no sistema onde arquivos podem ser salvos, por meio love.filesystem. Esses diretórios normalmente podem ser encontrados em algo como:  
+
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: <code>C:\Documents and Settings\user\Application Data\Love\</code> or <code>%appdata%\Love\</code>
+
*  Windows XP: <code>C:\Documents and Settings\user\Application Data\LOVE\</code> or <code>%appdata%\LOVE\</code>
* Windows Vista and 7: <code>C:\Users\user\AppData\Roaming\LOVE</code> or <code>%appdata%\Love\</code>
+
* Windows Vista e 7: <code>C:\Users\user\AppData\Roaming\LOVE</code> or <code>%appdata%\LOVE\</code>
*  Linux: <code>/home/user/.local/share/love/</code> or <code>~/.local/share/love/</code>
+
*  Linux: <code>$XDG_DATA_HOME/love/</code> or <code>~/.local/share/love/</code>
mac: <code>/Library/Application Support/LOVE/</code>
+
Mac: <code>/Users/user/Library/Application Support/LOVE/</code>
  
Os arquivos que são abertos para escrita ou acréscimo sempre serão criados no diretório save. O mesmo vale para outras operações que envolvem a escrita para o sistema de arquivos, como o mkdir.
+
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 que são abertos para leitura serão procurados no diretório save e depois na pasta raiz do jogo (nessa ordem). Se um arquivo com certo nome (e caminho) existe em ambos (.love-file e o diretório save), o diretório save terá precedência.
+
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 .love e ao diretório save. (Exceto para as chamadas get*Directory())
+
Nota: '''Todos''' os caminhos são relativos ao arquivo .love e ao diretório de escrita. (Exceto para as chamadas de get*Directory())  
  
Atualmente é necessário primeiro identificar o jogo com [[love.filesystem.setIdentity (Português)]].
+
É recomendado primeiro definir a identidade do seu jogo nos <code>[[conf.lua (Português)|Arquivos de Configuração]]</code>. Você também pode defini-la com <code>[[love.filesystem.setIdentity (Português)|love.filesystem.setIdentity]]()</code>.
== Types ==
+
== Tipos ==
{{#ask: [[Category:Types]] [[parent::love.filesystem (Português)]]
+
{{#ask: [[Category:Types]] [[parent::love.filesystem (Português)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?RealLink# -
 +
| ?DisplayName# -
 
}}
 
}}
 
+
== Funções ==
FileData Data representing the contents of a file
+
{{#ask: [[Category:Functions]] [[parent::love.filesystem (Português)]] [[Concept:Current]]
 
 
== Functions ==
 
{{#ask: [[Category:Functions]] [[parent::love.filesystem (Português)]]
 
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?RealLink# -
 +
| ?DisplayName# -
 
}}
 
}}
 
love.filesystem.write Write data to a file
 
 
 
== Enums ==
 
== Enums ==
{{#ask: [[Category:Enums]] [[parent::love.filesystem (Português)]]
+
{{#ask: [[Category:Enums]] [[parent::love.filesystem (Português)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?RealLink# -
 +
| ?DisplayName# -
 
}}
 
}}
 
FileDecoder How to decode a given FileData.
 
 
 
[[Category:Modules]]
 
[[Category:Modules]]
{{#set:Description=Provê uma interface para o sistema de arquivos do usuário.
+
{{#set:Description=Provê uma interface para o sistema de arquivos do usuário. }}
}}
 
 
== Veja Também ==
 
== Veja Também ==
* [[parent::love (Português)]]
+
* [[parent::love (Português)|love]]
 
+
{{#set:Since=000}}
== Outros Idiomas ==
+
== Outras Línguas ==
 
{{i18n|love.filesystem}}
 
{{i18n|love.filesystem}}

Latest revision as of 22:28, 12 September 2014

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

Enums

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

Veja Também

Outras Línguas