Difference between revisions of "love.filesystem (Français)"

(Correction de la description (Anglais->Français))
(update translation following current english documentation page)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
Fournit une interface pour le système de fichiers des utilisateurs.
+
Fournit une interface de gestion du système de fichiers de l'utilisateur.
  
−
Ce module fournit l'accès aux fichiers dans deux endroits et seulement deux endroits:
+
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 [[love.filesystem.getSourceBaseDirectory|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 :
  
−
*  Le dossier racine de .love-file. (Alternativement un répertoire).
 
−
*  Le dossier racine du répertoire donné.
 
  
−
A chaque jeu est accordé un seul répertoire sur le système où les fichiers peuvent être sauvés grâce à love.filesystem. Ces répertoires vont être typiquement trouvés dans quelque chose comme:
+
{| border="1" cellpadding="5" cellspacing="1" style="background-color:#E9F5FF; border: 1px solid #83C0F0;"
 +
! OS
 +
! Chemin
 +
! Alternative
 +
! Notes
 +
|-
 +
    |Windows XP
 +
    |<code>C:\Documents and Settings\user\Application Data\LOVE\</code>
 +
    |<code>%appdata%\LOVE\</code>
 +
    |Lorsque fusionné, un répertoire de sauvegarde sera crée directement à l'intérieur de <code>Application Data</code>, plutôt que dans un sous-répertoire de <code>LOVE</code>.
 +
|-
 +
    |Windows Vista, 7, 8 et 10
 +
    |<code>C:\Users\user\AppData\Roaming\LOVE</code>
 +
    |<code>%appdata%\LOVE\</code>
 +
    |Lorsque fusionné, un répertoire de sauvegarde sera crée directement à l'intérieur de <code>AppData</code>, plutôt que dans un sous-répertoire de <code>LOVE</code>.
 +
|-
 +
    |Mac
 +
    |<code>/Users/user/Library/Application Support/LOVE/</code>
 +
    | -
 +
    | -
 +
|-
 +
    |Linux
 +
    |<code>$XDG_DATA_HOME/love/</code>
 +
    |<code>~/.local/share/love/</code>
 +
    | -
 +
|-
 +
    |Android
 +
    |<code>/data/user/0/org.love2d.android/files/save/</code>
 +
    |<code>/data/data/org.love2d.android/files/save/</code>
 +
    |Sous Android il y à différentes emplacements de sauvegarde. SI ceux-ci ne fonctionnent pas, vous pouvez utiliser la fonction <code>[[love.filesystem.getSaveDirectory (Français)|love.filesystem.getSaveDirectory()]]</code> pour vérifier.
 +
|}
  
−
*  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>
 
−
*  Linux: <code>/home/user/.love/</code> or <code>~/.love/</code>
 
−
*  mac: <code>/Library/Application Support/LOVE/</code>
 
  
−
Les fichiers qui sont ouverts pour l' écriture ou pour la modification seront toujours créés dans le répertoire de sauvegarde. Il en va de même pour les autres opérations qui impliquent l' écriture du système de fichiers tel que mkdir.
+
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 [[Config Files (Français)|conf.lua]]. Vous pouvez également le régler à l'aide de [[love.filesystem.setIdentity (Français)|love.filesystem.setIdentity]].
  
−
Les fichiers qui seront ouverts pour la lecture seront recherché d'abord dans le répertoire de sauvegarde, puis dans le dossier racine du jeu (dans cet ordre). Donc si un fichier avec un certain nom (et son chemin) existe à la fois dans .love-file et le fichier de sauvegarde,  celui qui est dans le répertoire de sauvegarde a la priorité.
 
  
−
Note: '''Tous''' les chemins sont relatifs au répertoire de sauvegarde et au répertoire .love. (Excepté pour l'appel de get*Directory())
 
  
−
Actuellement, vous devez définir l'identité de votre jeu avec [[love.filesystem.setIdentity]].
 
 
== Types ==
 
== Types ==
−
{{#ask: [[Category:Types]] [[parent::love.filesystem]]
+
{{#ask: [[Category:Types (Français)]] [[parent::love.filesystem (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 
}}
 
}}
 
== Fonctions ==
 
== Fonctions ==
−
{{#ask: [[Category:Functions]] [[parent::love.filesystem]]
+
{{#ask: [[Category:Functions (Français)]] [[parent::love.filesystem (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 +
| ?PrettyDeprecated
 
}}
 
}}
 
== Enums ==
 
== Enums ==
−
{{#ask: [[Category:Enums]] [[parent::love.filesystem]]
+
{{#ask: [[Category:Enums (Français)]] [[parent::love.filesystem (Français)]] [[Concept:Current]]
 
| headers=hide
 
| headers=hide
 +
| format=template
 +
| template=ListingFields
 +
| introtemplate=ListingIntro
 +
| outrotemplate=ListingOutro
 
| ?Description
 
| ?Description
 +
| ?PrettySince
 +
| ?PrettyRemoved
 
}}
 
}}
−
[[Category:Modules]]
+
[[Category:Modules (Français)]]
−
{{#set:Description=Fournit une interface pour le système de fichiers des utilisateurs.}}
+
{{#set:Description=Fournit une interface de gestion du système de fichiers de l'utilisateur.}}
−
== Voir aussi ==
+
== Voir également ==
 
* [[parent::love (Français)]]
 
* [[parent::love (Français)]]
−
 
+
{{#set:Since=000}}
−
== Autres Langues ==
+
== Autres langues ==
 
{{i18n|love.filesystem}}
 
{{i18n|love.filesystem}}

Latest revision as of 23:45, 24 January 2021

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

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

Retrieved from "https://love2d.org./w/index.php?title=love.filesystem_(Français)&oldid=26112"