Difference between revisions of "love.filesystem (Français)"
(Uncluttering seems to work, proceeding) |
(update translation following current english documentation page) |
||
(3 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | Fournit une interface | + | Fournit une interface de gestion du système de fichiers de l'utilisateur. |
− | Ce module fournit | + | 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 : | ||
− | |||
− | |||
− | + | {| 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. | ||
+ | |} | ||
− | |||
− | |||
− | |||
− | |||
− | Les fichiers qui sont | + | 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]]. | ||
− | |||
− | |||
− | |||
== 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= | + | {{#set:Description=Fournit une interface de gestion du système de fichiers de l'utilisateur.}} |
− | }} | + | == Voir également == |
− | == Voir | ||
* [[parent::love (Français)]] | * [[parent::love (Français)]] | ||
− | + | {{#set:Since=000}} | |
− | == Autres | + | == 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. | 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. | 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. | 0.7.0 | 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. | 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