このオブジェクトは分析フェーズで作成され、実行フェーズで読み書きされるファイルまたはディレクトリを表します。オープン ファイル ハンドルではないため、ファイルの内容を直接読み書きするために使用することはできません。代わりに、アクション作成関数に渡してルール実装関数でアクション グラフを構築するために使用します。詳しくは、ルールのページをご覧ください。
map_each
関数を使用せずに File
が Args
オブジェクトに渡された場合、path
フィールドの値が取得されて文字列に変換されます。
メンバー
- ベース名
- ディレクトリ名
- 拡張機能
- is_directory
- is_source
- オーナー
- パス
- ルート
- short_path
- tree_relative_path
ベース名
string File.basename
ディレクトリ名
string File.dirname
拡張機能
string File.extension
is_directory
bool File.is_directory
is_source
bool File.is_source
オーナー
Label File.owner
None
を返すことができます。
パス
string File.path
short_path
です。ルートは空でもかまいません。通常は、生成されていないファイル用です。生成されたファイルの場合、通常は設定固有のパスの一部が含まれ、そのファイルのビルドに使用されたターゲット CPU アーキテクチャなどをエンコードしています。ファイルがバイナリの実行ファイル内にある場合は、ファイルをマッピングするパスに short_path
を使用します。
root
root File.root
short_path
string File.short_path
tree_relative_path
string File.tree_relative_path
tree_relative_path
は、アクション コマンド(Args.add_all())でディレクトリを展開したファイルでのみ使用できます。他のタイプのファイルの場合、このフィールドにアクセスするとエラーになります。