Difference between revisions of "love.filesystem (日本語)"
m |
(Updated to 28313.) |
||
| (7 intermediate revisions by the same user not shown) | |||
| Line 9: | Line 9: | ||
love.filesystem によりゲームごとにシステムへファイルを保存できるディレクトリを提供します。この'''ディレクトリのみ''' love.filesystem はファイルを書き込めます。これらのディレクトリは主にこのようものとして見つかります: | love.filesystem によりゲームごとにシステムへファイルを保存できるディレクトリを提供します。この'''ディレクトリのみ''' love.filesystem はファイルを書き込めます。これらのディレクトリは主にこのようものとして見つかります: | ||
| − | + | {| border="1" cellpadding="5" cellspacing="1" style="background-color:#E9F5FF; border: 1px solid #83C0F0;" | |
| − | + | ! OS | |
| − | + | ! パス | |
| − | + | ! 別の場所 | |
| − | + | ! 注釈 | |
| + | |- | ||
| + | |Windows XP | ||
| + | |<code>C:\Documents and Settings\user\Application Data\LOVE\</code> | ||
| + | |<code>%appdata%\LOVE\</code> | ||
| + | |[[love.filesystem.isFused|結合型実行形式 (fused)]] で動作時、セーブディレクトリは <code>LOVE</code> のサブディレクトリではなく <code>Application Data</code> へ作成します。 | ||
| + | |- | ||
| + | |Windows Vista, 7, 8, 10 および 11 | ||
| + | |<code>C:\Users\user\AppData\Roaming\LOVE</code> | ||
| + | |<code>%appdata%\LOVE\</code> | ||
| + | |結合型実行形式 (fused) で動作時、セーブディレクトリは <code>LOVE</code> のサブディレクトリではなく <code>AppData</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/data/org.love2d.android/files/save/</code> | ||
| + | |<code>/sdcard/Android/data/org.love2d.android/files/save/</code> | ||
| + | |代替パスは [[Config Files (日本語)#externalstorage|t.externalstorage config]] オプションの有効時に使用します。 Android の制限により、上述のパスの配下にアクセスすることはできません。 | ||
| + | |} | ||
| − | 書き込みまたは追記を行うためファイルを開いた場合は常にセーブ・ディレクトリに作成されます。同様に | + | 書き込みまたは追記を行うためファイルを開いた場合は常にセーブ・ディレクトリに作成されます。同様に createDirectory (ディレクトリの作成) などファイルシステムへの書き込みを伴う他の操作でも該当します。 |
| − | ファイルを読み取るために開く場合はセーブ・ディレクトリおよびその後に .love | + | ファイルを読み取るために開く場合はセーブ・ディレクトリおよびその後に .love アーカイブを (この順序にて) 検索します。したがって、あるファイル名称(およびパス)を持つファイルがセーブ・ディレクトリおよび .love アーカイブの両方に存在する場合は、セーブ・ディレクトリ優先します。 |
注釈: '''全て'''のパスは .love アーカイブおよびセーブ・ディレクトリからの相対パスです(get*Directory() の呼び出しを除く)。 | 注釈: '''全て'''のパスは .love アーカイブおよびセーブ・ディレクトリからの相対パスです(get*Directory() の呼び出しを除く)。 | ||
| − | 最初にゲームの識別子を [[Config Files (日本語)|conf.lua]] | + | 最初にゲームの識別子を [[Config Files (日本語)|conf.lua]] で設定することを推奨します。ゲームの識別子は [[love.filesystem.setIdentity (日本語)|love.filesystem.setIdentity]] でも設定できます。 |
| + | |||
== 型 == | == 型 == | ||
{{#ask: [[Category:Types]] [[parent::love.filesystem (日本語)]] [[Concept:Current]] | {{#ask: [[Category:Types]] [[parent::love.filesystem (日本語)]] [[Concept:Current]] | ||
| Line 32: | Line 59: | ||
| ?PrettySince | | ?PrettySince | ||
| ?PrettyRemoved | | ?PrettyRemoved | ||
| + | | ?PrettyDeprecated | ||
}} | }} | ||
== 関数 == | == 関数 == | ||
| Line 43: | Line 71: | ||
| ?PrettySince | | ?PrettySince | ||
| ?PrettyRemoved | | ?PrettyRemoved | ||
| + | | ?PrettyDeprecated | ||
}} | }} | ||
== 列挙型 == | == 列挙型 == | ||
| Line 54: | Line 83: | ||
| ?PrettySince | | ?PrettySince | ||
| ?PrettyRemoved | | ?PrettyRemoved | ||
| + | | ?PrettyDeprecated | ||
}} | }} | ||
[[Category:Modules]] | [[Category:Modules]] | ||
| Line 61: | Line 91: | ||
{{#set:Since=000}} | {{#set:Since=000}} | ||
== そのほかの言語 == | == そのほかの言語 == | ||
| − | {{i18n|love.filesystem}} | + | {{i18n (日本語)|love.filesystem}} |
Latest revision as of 03:48, 30 June 2023
利用者のファイルシステムへのインターフェースを提供します。
このモジュールは特定の場所にあるファイルへのアクセスを提供します:
- .love アーカイブ (またはソースのディレクトリ) のルート・フォルダ。
- ゲームのセーブ・ディレクトリのルート・フォルダ。
- ゲームの .love アーカイブ (またはソース・ディレクトリ) のあるフォルダですが、特定の条件を満たしている場合に限ります。
love.filesystem によりゲームごとにシステムへファイルを保存できるディレクトリを提供します。このディレクトリのみ love.filesystem はファイルを書き込めます。これらのディレクトリは主にこのようものとして見つかります:
| OS | パス | 別の場所 | 注釈 |
|---|---|---|---|
| Windows XP | C:\Documents and Settings\user\Application Data\LOVE\
|
%appdata%\LOVE\
|
結合型実行形式 (fused) で動作時、セーブディレクトリは LOVE のサブディレクトリではなく Application Data へ作成します。
|
| Windows Vista, 7, 8, 10 および 11 | C:\Users\user\AppData\Roaming\LOVE
|
%appdata%\LOVE\
|
結合型実行形式 (fused) で動作時、セーブディレクトリは LOVE のサブディレクトリではなく AppData へ作成します。
|
| Mac | /Users/user/Library/Application Support/LOVE/
|
- | - |
| Linux | $XDG_DATA_HOME/love/
|
~/.local/share/love/
|
- |
| Android | /data/data/org.love2d.android/files/save/
|
/sdcard/Android/data/org.love2d.android/files/save/
|
代替パスは t.externalstorage config オプションの有効時に使用します。 Android の制限により、上述のパスの配下にアクセスすることはできません。 |
書き込みまたは追記を行うためファイルを開いた場合は常にセーブ・ディレクトリに作成されます。同様に createDirectory (ディレクトリの作成) などファイルシステムへの書き込みを伴う他の操作でも該当します。
ファイルを読み取るために開く場合はセーブ・ディレクトリおよびその後に .love アーカイブを (この順序にて) 検索します。したがって、あるファイル名称(およびパス)を持つファイルがセーブ・ディレクトリおよび .love アーカイブの両方に存在する場合は、セーブ・ディレクトリ優先します。
注釈: 全てのパスは .love アーカイブおよびセーブ・ディレクトリからの相対パスです(get*Directory() の呼び出しを除く)。
最初にゲームの識別子を conf.lua で設定することを推奨します。ゲームの識別子は love.filesystem.setIdentity でも設定できます。
型
| DroppedFile (日本語) | ウィンドウからドロップされたファイルを意味します。 |  0.10.0 |
|
| File (日本語) | ファイルシステムにあるファイルを提供します。 | ||
| FileData (日本語) | ファイルの内容を Data として提供します。 | 0.7.0 |
関数
列挙型
| FileDecoder (日本語) | FileData の復号化方法を指定します。 | 0.7.0 |
|
| FileMode (日本語) | 様々なモードでファイルを開くことができるようにします。 | ||
| FileType (日本語) | ファイルの種類。 | 11.0 |
