Difference between revisions of "love.filesystem (日本語)"
(Created page with "利用者のファイルシステムへのインターフェースを提供します。 このモジュールは特定の場所にあるファイルへのアクセスを提...") |
m |
||
(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> | ||
+ | |結合型実行形式 (fused) で動作時、セーブディレクトリは <code>LOVE</code> のサブディレクトリではなく <code>Application Data</code> へ作成します。 | ||
+ | |- | ||
+ | |Windows Vista, 7, 8 および 10 | ||
+ | |<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/user/0/org.love2d.android/files/save/</code> | ||
+ | |<code>/data/data/org.love2d.android/files/save/</code> | ||
+ | |Android では様々なセーブ先があります。これらが動作しない場合は、<code>love.filesystem.getSaveDirectory()</code> を確認のために使用できます。 | ||
+ | |} | ||
− | 書き込みまたは追記を行うためファイルを開いた場合は常にセーブ・ディレクトリに作成されます。同様に mkdir | + | 書き込みまたは追記を行うためファイルを開いた場合は常にセーブ・ディレクトリに作成されます。同様に mkdir (ディレクトリの作成) などファイルシステムへの書き込みを伴う他の操作でも該当します。 |
− | ファイルを読み取るために開く場合はセーブ・ディレクトリおよびその後に .love | + | ファイルを読み取るために開く場合はセーブ・ディレクトリおよびその後に .love アーカイブを (この順序にて) 検索します。したがって、あるファイル名称(およびパス)を持つファイルがセーブ・ディレクトリおよび .love アーカイブの両方に存在する場合は、セーブ・ディレクトリ優先します。 |
注釈: '''全て'''のパスは .love アーカイブおよびセーブ・ディレクトリからの相対パスです(get*Directory() の呼び出しを除く)。 | 注釈: '''全て'''のパスは .love アーカイブおよびセーブ・ディレクトリからの相対パスです(get*Directory() の呼び出しを除く)。 | ||
− | 最初にゲームの識別子を [[Config Files (日本語)|conf.lua]] | + | 最初にゲームの識別子を [[Config Files (日本語)|conf.lua]] で設定することを推奨します。ゲームの識別子は [[love.filesystem.setIdentity (日本語)|love.filesystem.setIdentity]] でも設定できます。 |
+ | |||
+ | {{notice|[[0.10.0 (日本語)|0.10.0]] ~ [[0.10.2 (日本語)|0.10.2]] において Android Marshmallow 以降のバージョンでゲームのセーブディレクトリへの各種処理 (すなわち[[love.filesystem.write (日本語)|書き込み]]) が失敗する[https://bitbucket.org/MartinFelis/love-android-sdl2/issues/132 不具合]があります。回避策は [[Config_Files#externalstorage (日本語)|externalstorage]] の設定を有効にします。}} | ||
+ | |||
== 型 == | == 型 == | ||
{{#ask: [[Category:Types]] [[parent::love.filesystem (日本語)]] [[Concept:Current]] | {{#ask: [[Category:Types]] [[parent::love.filesystem (日本語)]] [[Concept:Current]] | ||
Line 32: | Line 61: | ||
| ?PrettySince | | ?PrettySince | ||
| ?PrettyRemoved | | ?PrettyRemoved | ||
+ | | ?PrettyDeprecated | ||
}} | }} | ||
== 関数 == | == 関数 == | ||
Line 43: | Line 73: | ||
| ?PrettySince | | ?PrettySince | ||
| ?PrettyRemoved | | ?PrettyRemoved | ||
+ | | ?PrettyDeprecated | ||
}} | }} | ||
== 列挙型 == | == 列挙型 == | ||
Line 54: | Line 85: | ||
| ?PrettySince | | ?PrettySince | ||
| ?PrettyRemoved | | ?PrettyRemoved | ||
+ | | ?PrettyDeprecated | ||
}} | }} | ||
[[Category:Modules]] | [[Category:Modules]] | ||
− | {{#set:利用者のファイルシステムへのインターフェースを提供します。}} | + | {{#set:Description=利用者のファイルシステムへのインターフェースを提供します。}} |
== 関連 == | == 関連 == | ||
* [[parent::love (日本語)]] | * [[parent::love (日本語)]] | ||
{{#set:Since=000}} | {{#set:Since=000}} | ||
== そのほかの言語 == | == そのほかの言語 == | ||
− | {{i18n|love.filesystem}} | + | {{i18n (日本語)|love.filesystem}} |
Revision as of 01:54, 26 June 2019
利用者のファイルシステムへのインターフェースを提供します。
このモジュールは特定の場所にあるファイルへのアクセスを提供します:
- .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 | 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/user/0/org.love2d.android/files/save/
|
/data/data/org.love2d.android/files/save/
|
Android では様々なセーブ先があります。これらが動作しない場合は、love.filesystem.getSaveDirectory() を確認のために使用できます。
|
書き込みまたは追記を行うためファイルを開いた場合は常にセーブ・ディレクトリに作成されます。同様に mkdir (ディレクトリの作成) などファイルシステムへの書き込みを伴う他の操作でも該当します。
ファイルを読み取るために開く場合はセーブ・ディレクトリおよびその後に .love アーカイブを (この順序にて) 検索します。したがって、あるファイル名称(およびパス)を持つファイルがセーブ・ディレクトリおよび .love アーカイブの両方に存在する場合は、セーブ・ディレクトリ優先します。
注釈: 全てのパスは .love アーカイブおよびセーブ・ディレクトリからの相対パスです(get*Directory() の呼び出しを除く)。
最初にゲームの識別子を conf.lua で設定することを推奨します。ゲームの識別子は love.filesystem.setIdentity でも設定できます。
0.10.0 ~ 0.10.2 において Android Marshmallow 以降のバージョンでゲームのセーブディレクトリへの各種処理 (すなわち書き込み) が失敗する不具合があります。回避策は externalstorage の設定を有効にします。 |
型
DroppedFile (日本語) | ウィンドウからドロップされたファイルを意味します。 | 0.10.0 | |
File (日本語) | ファイルシステムにあるファイルを提供します。 | ||
FileData (日本語) | ファイルの内容を Data として提供します。 | 0.7.0 |
関数
列挙型
FileDecoder (日本語) | FileData の復号化方法を指定します。 | 0.7.0 | |
FileMode (日本語) | 様々なモードでファイルを開くことができるようにします。 | ||
FileType (日本語) | ファイルの種類。 | 11.0 |