std.file
Jump to: DirEntry FileException SpanMode append breadth chdir copy creationTime depth dirEntries errno exists getAttributes getSize getTimes getcwd isdir isfile lastAccessTime lastModified lastWriteTime listdir mkdir mkdirRecurse name read readText remove rename rmdir rmdirRecurse setTimes shallow size slurp write
std/file.d
License:
Boost License 1.0. Authors:
Walter Bright, Andrei Alexandrescu
- ファイル入出力エラーが発生したときに投げられる例外です。
- OSのエラーコードです。
- this(in char[] name, in char[] message);
- ファイルの名前とエラーメッセージ を受け取るコンストラクタです。
- this(in char[] name, uint errno = GetLastError);
- ファイルの名前とエラー番号 (Windows では GetLastError、Posix では getErrno) を受け取るコンストラクタです。
- ファイル name を読み取り、読み込まれたbyteの配列を返します。
ファイルが upTo よりも大きいときは upTo
バイトまで読み込まれます。
Example:
import std.file, std.stdio; void main() { auto bytes = cast(ubyte[]) read("filename", 5); if (bytes.length == 5) writefln("The fifth byte of the file is 0x%x", bytes[4]); }
Returns:
型の指定されていない、読み込まれたバイト配列 Throws:
FileException をエラー時に投げる
- テキストファイルを読み込んで検証して返します。(検証には std.utf.validate を使用します)。S
は文字幅とconst性の任意の組み合わせの文字列型が指定できます。
文字幅変換は行われません。ファイル
name のエンコーディングと S
のエンコーディングが違う場合は、検証エラーになります。
Returns:
読み込まれた文字列 Throws:
ファイルエラー時には FileException。 UTFデコードエラー時には UtfException。 Example:
enforce(system("echo abc>deleteme") == 0); scope(exit) remove("deleteme"); enforce(chomp(readText("deleteme")) == "abc");
- ファイル name[] に buffer[] を書き込みます。
Throws:
FileException をエラー時に投げる Example:
import std.file; void main() { int[] a = [ 0, 1, 1, 2, 3, 5, 8 ]; write("filename", a); assert(cast(int[]) read("filename") == a); }
- ファイル name に buffer[] を追記します。
Throws:
FileException on error. Example:
import std.file; void main() { int[] a = [ 0, 1, 1, 2, 3, 5, 8 ]; write("filename", a); int[] b = [ 13, 21 ]; append("filename", b); assert(cast(int[]) read("filename") == a ~ b); }
- ファイル from を to に改名します。
Throws:
FileException をエラー時に投げる
- ファイル name を削除します。
Throws:
FileException をエラー時に投げる
- ファイル name[] のサイズを取得します。
Throws:
FileException をエラー時に投げる
- ファイル name[] の 作成/最終アクセス/更新日時を返します。
Throws:
FileException をエラー時に投げる
- ファイル name の最終更新日時を返します。 ファイルが存在しない場合、FileException を投げます。
- ファイル name の最終更新日時を返します。
ファイルが存在しない場合、returnIfMissing を返します。
典型的な使用例としては、
make や ant のようなビルド自動化ツールがあります。ファイル target をファイル source から再ビルドする必要があるかどうか (つまり target が
source より古いか存在しないケース) のチェックをするには、
以下のような比較を行います。source が存在しない場合には
(存在すべきなので) FileException 例外を投げます。その一方で、
target が存在しない場合には、デフォルト値 d_time.min
を返すことで無限に古いファイルという扱いにし、正しくビルドを行います。
if (lastModified(source) >= lastModified(target, d_time.min)) { // (再)ビルドが必要 } else { // target は最新版 }
- ファイル(またはディレクトリ) name[] が存在するかどうか
- ファイル name の属性を得ます。
Throws:
FileException をエラー時に投げる
- name がディレクトリかどうか
Throws:
name が存在しなければ FileException を投げる - name はファイルか?
Throws:
name が存在しなければ FileException を投げる
- カレントディレクトリを pathname に変更
Throws:
FileException をエラー時に投げる
- ディレクトリ pathname を作成
Throws:
FileException をエラー時に投げる
- ディレクトリと、もし存在しなければその親ディレクトリを再帰的に作成
- ディレクトリ pathname を削除
Throws:
FileException をエラー時に投げる
- カレントディレクトリを取得
Throws:
FileException をエラー時に投げる
- ディレクトリエントリ
- ファイルかディレクトリの名前
- ファイルのバイト数
- ファイル作成日時
- ファイル最終アクセス日時
- ファイル最終更新日時
- DirEntryがディレクトリの場合true
- DirEntryがファイルの場合true
- pathname 内のファイルそれぞれに対応する DirEntry を列挙して、
callback delegate に渡します。
Note:
この関数は取り除かれる予定です。新しいコードでは dirEntries (下参照) を使用してください。 Parameters:
Example:bool delegate(DirEntry* de) callback 毎回それぞれのパス文字列を処理する Delegate。 処理を続行するには true を、 終了するには false を返すこと。
このプログラムは、自身を含めパス引数以下の全てのファイルを リストアップします。import std.stdio; import std.file; void main(string[] args) { bool callback(DirEntry* de) { if (de.isdir) listdir(de.name, &callback); else writefln(de.name); return true; } listdir(args[1], &callback); }
- ファイル from をファイル to へコピーします。タイムスタンプは保たれます。
- ファイル name のアクセス/更新日時を設定します。
Throws:
エラー時に FileException - ディレクトリと、 サブディレクトリを含むその中身を再帰的に削除します。
- dirEntries (下を参照) に指定するディレクトリ展開モードの指定
- ディレクトリ1つの中身だけを列挙します(サブディレクトリには潜りません)
- ディレクトリを深さ優先(※訳注: 帰りがけ順?)で列挙します。つまり、 サブディレクトリの中身がサブディレクトリ自身より先に列挙されます。 例として、再帰的にファイルを削除する場合などに便利です。
- ディレクトリを幅優先(※訳注: 行きがけ順?)で列挙します。つまり、 サブディレクトリ自身の直後に中身列挙が行われます。
- foreachでディレクトリの内容を列挙します。foreachで情報を受け取る変数の型は
名前のみ必要なら string、追加情報まで必要なら DirEntry とします。引数 mode は、
ディレクトリをたどる順番の指定です。ファイル名として返される文字列には、
path が接頭辞として含まれます。
Example:
// ディレクトリ内をdepthモードで列挙 foreach (string name; dirEntries("destroy/me", SpanMode.depth)) { remove(name); } // ディレクトリ内をbreadthモードで列挙 foreach (string name; dirEntries(".", SpanMode.breadth)) { writeln(name); } // ディレクトリ内を詳細な情報付きで列挙 foreach (DirEntry e; dirEntries("dmd-testing", SpanMode.breadth)) { writeln(e.name, "\t", e.size); }
- ファイル全体を配列に読み込みます。
Example:
// ファイルのロード; 各行は int, double の形式 // とする auto a = slurp!(int, double)("filename", "%s, %s");
- ディレクトリの内容を返します。
内容の名前には pathname は含まれません。
Throws:
FileException をエラー時に投げる Example:
このプログラムは、指定されたパス引数内の全てのファイルと サブディレクトリをリストアップします。import std.stdio; import std.file; void main(string[] args) { auto dirs = std.file.listdir(args[1]); foreach (d; dirs) writefln(d); }
- ディレクトリとサブディレクトリにある全てのファイルのうち、
pattern または正規表現 r にマッチするもののみを返します。
Parameters:
Example:char[] pathname ディレクトリ名 char[] pattern ワイルドカード入り文字列。例えば "*.d" 対応しているワイルドカード文字列は、 std.path の fnmatch() に記述されています。 r 正規表現です。より強力なパターンマッチに使用します。
このプログラムは、第一引数として渡されたパス上にある 拡張子 "d" のファイルを全てリストアップします。import std.stdio; import std.file; void main(string[] args) { auto d_source_files = std.file.listdir(args[1], "*.d"); foreach (d; d_source_files) writefln(d); }
"d" もしくは "obj" の拡張子を持つファイルを探す、 正規表現バージョンです:import std.stdio; import std.file; import std.regexp; void main(string[] args) { auto d_source_files = std.file.listdir(args[1], RegExp(r"\.(d|obj)$")); foreach (d; d_source_files) writefln(d); }
- pathname 内の全てのファイルとディレクトリ名を、
callback delegate に渡します。
Note:
この関数は非推奨となりました。新しいコードでは dirEntries (下参照) を使用してください。 Parameters:
Example:bool delegate(string filename) callback それぞれのパス文字列を処理する Delegate。 処理を続行するには true を、 終了するには false を返すこと。
このプログラムは、自身を含めパス引数以下の全てのファイルを リストアップします。import std.stdio; import std.path; import std.file; void main(string[] args) { auto pathname = args[1]; string[] result; bool listing(string filename) { result ~= std.path.join(pathname, filename); return true; // continue } listdir(pathname, &listing); foreach (name; result) writefln("%s", name); }