love.filesystem (Français)

Fournit une interface de gestion du système de fichiers de l'utilisateur.

Ce module fournit des accès aux fichiers dans des emplacements spécifiques :

  • Le répertoire racine de l'archive .love (ou le répertoire source)
  • Le répertoire racine du dossier de sauvegarde du jeu.
  • Le répertoire contenant l'archive .love du jeu (ou le répertoire source), mais seulement, si certaines conditions sont réunies.

Chaque jeu est autorisé à un simple dossier du système, où les fichiers peuvent être sauvegardés via love.filesystem. C'est le seul répertoire où love.filesysteme peut écrire des fichiers. Ces répertoires se situent typiquement dans quelque chose comme :


OS Chemin Alternative Notes
Windows XP C:\Documents and Settings\user\Application Data\LOVE\ %appdata%\LOVE\ Lorsque fusionné, un répertoire de sauvegarde sera crée directement à l'intérieur de Application Data, plutôt que dans un sous-répertoire de LOVE.
Windows Vista, 7, 8 et 10 C:\Users\user\AppData\Roaming\LOVE %appdata%\LOVE\ Lorsque fusionné, un répertoire de sauvegarde sera crée directement à l'intérieur de AppData, plutôt que dans un sous-répertoire de LOVE.
Mac /Users/user/Library/Application Support/LOVE/ - -
Linux $XDG_DATA_HOME/love/ ~/.local/share/love/ -
Android /data/user/0/org.love2d.android/files/save/ /data/data/org.love2d.android/files/save/ Sous Android il y à différentes emplacements de sauvegarde. SI ceux-ci ne fonctionnent pas, vous pouvez utiliser la fonction love.filesystem.getSaveDirectory() pour vérifier.


Les fichiers qui sont ouvert en écriture ou ajout seront toujours créés dans de le répertoire de sauvegarde. Il en va de même pour les autres opérations qui impliquent des écritures sur le système de fichier, comme createDirectory.

Les fichiers ouverts en lecture seront d'abord cherché dans le dossier de sauvegarde, puis ensuite dans l'archive .love (dans cet ordre). Donc, si un fichier avec un certain nom de fichier (et chemin) existe à la fois dans l'archive .love et dans le dossier de sauvegarde, celui du répertoire de sauvegarde et lu en priorité.

Note: Tous les chemins sont relatifs à l'archive .love et au répertoire de sauvegarde. (à l'exception des appels à get*Directory())

Il est recommandé de régler l'identité de votre jeu en premier dans votre fichier conf.lua. Vous pouvez également le régler à l'aide de love.filesystem.setIdentity.


Types

DroppedFile (Français) Represents a file dropped from the window. Added since 0.10.0
FileData (Français) Data (données) représentant le contenu d'un fichier.

Fonctions

love.filesystem.append (Français) Ajoute des données à un fichier existant.
love.filesystem.areSymlinksEnabled (Français) Vérifie si love.filesystem suit les liens symboliques.
love.filesystem.createDirectory (Français) Crée un répertoire, récursivement.
love.filesystem.getAppdataDirectory (Français) Retourne le répertoire de données de l'application (pourrait être le même que getUserDirectory)
love.filesystem.getCRequirePath (Français) Récupère les chemins du système de fichier qui vont être recherchés pour les bibliothèques en c lorsque require (requiert) est appelé.
love.filesystem.getDirectoryItems (Français) Retourne la liste des fichiers et sous-dossiers contenus dans un dossier.
love.filesystem.getIdentity (Français) Récupère le nom du dossier d'écriture de votre jeu.
love.filesystem.getInfo (Français) Récupère des informations à propos d'un fichier ou répertoire spécifié.
love.filesystem.getRealDirectory (Français) Récupère le chemin absolu du dossier contenant le chemin de fichier.
love.filesystem.getRequirePath (Français) Récupère les chemins du système de fichier qui seront recherchés lorsque require (requiert) est appelé.
love.filesystem.getSaveDirectory (Français) Récupère le chemin complet du répertoire de sauvegarde désigné.
love.filesystem.getSource (Français) Retourne le chemin complet du fichier ou répertoire .love.
love.filesystem.getUserDirectory (Français) Retourne le chemin du répertoire de l'utilisateur
love.filesystem.getWorkingDirectory (Français) Récupère le répertoire de travail actuel.
love.filesystem.init (Français) Initialise love.filesystem, sera appelé en interne, ne devrait donc pas être utilisé explicitement.
love.filesystem.isFused (Français) Gets whether the game is in fused mode or not.
love.filesystem.isSymlink (Français) Vérifie si un chemin de fichier est un lien symbolique.
love.filesystem.lines (Français) Lit des lignes par itérations dans un fichier.
love.filesystem.load (Français) Charge un fichier Lua (mais ne l’exécute qu'optionnellement).
love.filesystem.mount (Français) Monte un fichier zip ou un dossier dans le répertoire de sauvegarde du jeu pour lecture.
love.filesystem.newFile (Français) Crée un nouvel objet File.
love.filesystem.newFileData (Français) Crée un nouvel objet FileData (données de fichier) à partir d'un fichier sur le système de fichiers ou d'une chaîne de caractères en mémoire. Added since 0.7.0
love.filesystem.read (Français) Lit le contenu d'un fichier.
love.filesystem.setCRequirePath (Français) Règle les chemins du système de fichier qui vont être recherchés pour les bibliothèques en c lorsque require (requiert) est appelé..
love.filesystem.setIdentity (Français) Règle le dossier d'écriture de votre jeu.
love.filesystem.setRequirePath (Français) Règle les chemins du système de fichier qui seront recherchés lorsque require (requiert) est appelé.
love.filesystem.setSource (Français) Règle les sources du jeu, où le code est présent. Utilisé en interne.
love.filesystem.setSymlinksEnabled (Français) Règle si le love.filesystem doit suivre les liens symboliques.
love.filesystem.unmount (Français) Démonte un fichier zip ou un dossier monté auparavant avec love.filesystem.mount.
love.filesystem.write (Français) Écrit des données dans un fichier.

Enums

FileDecoder (Français) Comment décoder un FileData (données de fichier) donnée. Added since 0.7.0 Removed in 11.0
FileMode (Français) Les différents modes dans lesquels vous pouvez ouvrir un File (fichier).
FileType (Français) Le type d'un fichier. Added since 11.0

Voir également

Autres langues