love.filesystem (Deutsch)

Bietet eine Schnittstelle zum Dateisystem des Benutzers.

Dieses Modul bietet Zugang zu Dateien in zwei Orten und nur zwei Orten:

  • Dem Root-Ordner des love. Archivs (auch: Quellverzeichnis)
  • Dem Root-Ordner des Speicherverzeichnisses des jeweiligen Spiels.

Jedem Spiel wird der Zugang zu einem Verzeichnis im System, wo Dateien durch love.filesystem abgespeichert werden können, gewährt. Das ist das einzige Verzeichnis wo love.filesystem Dateien schreiben kann. Dieses Verzeichnis wird hier gefunden:

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

Dateien die mit write oder append geöffnet sind, werden immer im Speicherverzeichnis abgespeichert. Dasselbe gilt für andere Operationen die das Schreiben ins Dateisystem miteinbeziehen, wie zum Beispiel mkdir.

Dateien die mit read geöffnet sind werden im Speicherverzeichniss und danach im .love Archiv (im selben Ordner) gesucht. D.h. wenn eine Datei mit einem bestimmten Dateinamen (und Pfad) sowohl im .love Archiv als auch im Speicherverzeichnis existiert, dann wird die Datei im Speicherverzeichnis bevorzugt.

Merke: Alle Pfade sind relativ zum .love Archiv und dem Speicherverzeichnis. (Außer bei get*Directory() Befehlen)

Es ist empfohlen die Identität des Spiels zuerst in Ihrer conf.lua Datei festzusetzen. Sie können diese auch mit love.filesystem.setIdentity() einstellen.

Typen

DroppedFileRepresents a file dropped from the window.
FileRepresents a file on the filesystem.
FileDataData representing the contents of a file.

Funktionen

love.filesystem.appendAppend data to an existing file.
love.filesystem.areSymlinksEnabledGets whether love.filesystem follows symbolic links.
love.filesystem.createDirectoryCreates a directory.
love.filesystem.enumerateReturns all the files and subdirectories in the directory.
love.filesystem.existsCheck whether a file or directory exists.
love.filesystem.getAppdataDirectoryReturns the application data directory (could be the same as getUserDirectory)
love.filesystem.getCRequirePathGets the filesystem paths that will be searched for c libraries when require is called.
love.filesystem.getDirectoryItemsReturns all the files and subdirectories in the directory.
love.filesystem.getIdentityGets the write directory name for your game.
love.filesystem.getInfoGets information about the specified file or directory.
love.filesystem.getLastModifiedGets the last modification time of a file.
love.filesystem.getRealDirectoryGets the absolute path of the directory containing a filepath.
love.filesystem.getRequirePathGets the filesystem paths that will be searched when require is called.
love.filesystem.getSaveDirectoryGets the full path to the designated save directory.
love.filesystem.getSizeGets the size in bytes of a file.
love.filesystem.getSourceReturns the full path to the .love file or directory.
love.filesystem.getSourceBaseDirectoryReturns the full path to the directory containing the .love file.
love.filesystem.getUserDirectoryReturns the path of the user's directory
love.filesystem.getWorkingDirectoryGets the current working directory.
love.filesystem.initInitializes love.filesystem, will be called internally, so should not be used explicitly.
love.filesystem.isDirectoryCheck whether something is a directory.
love.filesystem.isFileCheck whether something is a file.
love.filesystem.isFusedGets whether the game is in fused mode or not.
love.filesystem.isSymlinkGets whether a filepath is actually a symbolic link.
love.filesystem.linesIterate over the lines in a file.
love.filesystem.loadLoads a Lua file (but does not run it).
love.filesystem.mkdirCreates a directory.
love.filesystem.mountMounts a zip file or folder in the game's save directory for reading.
love.filesystem.newFileCreates a new File object.
love.filesystem.newFileDataCreates a new FileData object from a file on disk, or from a string in memory.
love.filesystem.readRead the contents of a file.
love.filesystem.removeRemoves a file (or directory).
love.filesystem.setCRequirePathSets the filesystem paths that will be searched for c libraries when require is called.
love.filesystem.setIdentitySets the write directory for your game.
love.filesystem.setRequirePathSets the filesystem paths that will be searched when require is called.
love.filesystem.setSourceSets the source of the game, where the code is present. Used internally.
love.filesystem.setSymlinksEnabledSets whether love.filesystem follows symbolic links.
love.filesystem.unmountUnmounts a zip file or folder previously mounted with love.filesystem.mount.
love.filesystem.writeWrite data to a file.

Aufzählungstypen

FileDecoderHow to decode a given FileData.
FileModeThe different modes you can open a File in.
FileTypeThe type of a file.

Siehe auch

Andere Sprachen