love.filesystem (Français)

love.filesystem propose une interface de gestion des fichiers côté utilisateur.

Néanmoins, le champ d'action de ce module est restreint à ces quelques emplacements :

• L'archive .love qui contient le jeu (ou, si elle n'existe pas, le répertoire source dans lequel est stocké le jeu).
• Le dossier de sauvegarde du jeu.
• Le dossier parent contenant l'archive .love (ou, le cas échéant, le répertoire source dans lequel est stocké le jeu) si et seulement si certaines conditions sont réunies.

Chaque jeu possède un répertoire sur le disque dur dans lequel on peut enregistrer des fichiers par le biais de love.filesystem. Il est important de noter qu'il s'agît du seul répertoire dans lequel love.filesystem peut écrire.

Par défaut, on trouve ces répertoires dans les emplacements suivants :

• Windows XP : C:\Documents and Settings\user\Application Data\LOVE\ ou %appdata%\LOVE\.
• Windows Vista et Windows 7 : C:\Users\user\AppData\Roaming\LOVE ou %appdata%\LOVE\.
• Linux : $XDG_DATA_HOME/love/ ou ~/.local/share/love/.
• Mac OS : /Users/user/Library/Application Support/LOVE/.
• Android : /data/user/0/org.love2d.android/files/save/ ou /data/data/org.love2d.android/files/save/ (on trouve différents emplacements de sauvegarde sous Android, si ces derniers ne fonctionnent pas, utilisez love.filesystem.getSaveDirectory() pour obtenir son emplacement).

L'écriture ou la modification de fichiers s’effectueront toujours dans le répertoire de sauvegarde. Les opérations semblables (comme mkdir) sont soumises aux mêmes contraintes.

Lors de la lecture de fichiers, il est de mise de retenir que les fichiers seront d'abord recherchés dans le dossier de sauvegarde, puis dans l'archive .love (ou, le cas échéant, dans le répertoire source qui stocke le jeu). Ainsi, sur deux fichiers possédant le même nom (et le même chemin d'accès) se trouvant dans les deux emplacements, on note que c'est le fichier se trouvant dans le dossier de sauvegarde qui aura la priorité.

Note : Tous les chemins d'accès sont relatifs au dossier de sauvegarde et à l'archive .love (excepté pour l'utilisation de get*Directory()).

Il vous est recommandé de déclarer l'identité de votre jeu (qui correspond au nom du dossier de sauvegarde) dans votre conf.lua. Vous pouvez utiliser love.filesystem.setIdentity pour le faire.

Objets

DroppedFile	Represents a file dropped from the window.
File	Represents a file on the filesystem.
FileData	Data representing the contents of a file.

Fonctions

love.filesystem.append	Append data to an existing file.
love.filesystem.areSymlinksEnabled	Gets whether love.filesystem follows symbolic links.
love.filesystem.createDirectory	Creates a directory.
love.filesystem.enumerate	Returns all the files and subdirectories in the directory.
love.filesystem.exists	Check whether a file or directory exists.
love.filesystem.getAppdataDirectory	Returns the application data directory (could be the same as getUserDirectory)
love.filesystem.getCRequirePath	Gets the filesystem paths that will be searched for c libraries when require is called.
love.filesystem.getDirectoryItems	Returns all the files and subdirectories in the directory.
love.filesystem.getIdentity	Gets the write directory name for your game.
love.filesystem.getInfo	Gets information about the specified file or directory.
love.filesystem.getLastModified	Gets the last modification time of a file.
love.filesystem.getRealDirectory	Gets the absolute path of the directory containing a filepath.
love.filesystem.getRequirePath	Gets the filesystem paths that will be searched when require is called.
love.filesystem.getSaveDirectory	Gets the full path to the designated save directory.
love.filesystem.getSize	Gets the size in bytes of a file.
love.filesystem.getSource	Returns the full path to the .love file or directory.
love.filesystem.getSourceBaseDirectory	Returns the full path to the directory containing the .love file.
love.filesystem.getUserDirectory	Returns the path of the user's directory
love.filesystem.getWorkingDirectory	Gets the current working directory.
love.filesystem.init	Initializes love.filesystem, will be called internally, so should not be used explicitly.
love.filesystem.isDirectory	Check whether something is a directory.
love.filesystem.isFile	Check whether something is a file.
love.filesystem.isFused	Gets whether the game is in fused mode or not.
love.filesystem.isSymlink	Gets whether a filepath is actually a symbolic link.
love.filesystem.lines	Iterate over the lines in a file.
love.filesystem.load	Loads a Lua file (but does not run it).
love.filesystem.mkdir	Creates a directory.
love.filesystem.mount	Mounts a zip file or folder in the game's save directory for reading.
love.filesystem.mountFullPath	Mounts a full platform-dependent path to a zip file or folder for reading or writing in love.filesystem.
love.filesystem.newFile	Creates a new File object.
love.filesystem.newFileData	Creates a new FileData object from a file on disk, or from a string in memory.
love.filesystem.openFile	Opens a new File object, which represents an existing or new file on disk.
love.filesystem.read	Read the contents of a file.
love.filesystem.remove	Removes a file (or directory).
love.filesystem.setCRequirePath	Sets the filesystem paths that will be searched for c libraries when require is called.
love.filesystem.setIdentity	Sets the write directory for your game.
love.filesystem.setRequirePath	Sets the filesystem paths that will be searched when require is called.
love.filesystem.setSource	Sets the source of the game, where the code is present. Used internally.
love.filesystem.setSymlinksEnabled	Sets whether love.filesystem follows symbolic links.
love.filesystem.unmount	Unmounts a zip file or folder previously mounted with love.filesystem.mount.
love.filesystem.unmountFullPath	Unmounts a zip file or folder previously mounted with love.filesystem.mountFullPath.
love.filesystem.write	Write data to a file.

Enums

FileDecoder	How to decode a given FileData.
FileMode	The different modes you can open a File in.
FileType	The type of a file.
LoadMode	Possible load modes for love.filesystem.load.

Voir aussi

• love (Français)

Autres Langues

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info