map_each
関数を使用せずに File
が Args
オブジェクトに渡された場合、path
フィールドの値が取得されて文字列に変換されます。
メンバー
- basename
- dirname
- 拡張機能
- is_directory
- is_source
- owner
- path
- root
- short_path
- tree_relative_pathtree_relative_path
basename
string File.basenameこのファイルのベース名。これは、ディレクトリ内のファイルの名前です。
dirname
string File.dirnameこのファイルを含むディレクトリの名前。path から取得され、常に実行ディレクトリからの相対パスになります。
拡張機能
string File.extensionこのファイルのファイル拡張子。右端のピリオドは含みません。ファイルのベース名にピリオドが含まれていない場合は空の文字列。
is_directory
bool File.is_directoryディレクトリの場合は true を返します。
is_source
bool File.is_sourceこれがソースファイルである(生成されていない)場合は true を返します。
所有者
Label File.ownerこのファイルを生成するターゲットのラベル。
None
が返されることがあります。
パス
string File.pathこのファイルの実行パス(ワークスペースの実行ディレクトリを基準とする相対パス)。これは 2 つの部分で構成されます。1 つ目の部分は root と呼ばれ(root モジュールも参照してください)、2 つ目の部分は
short_path
です。ルートは空でもかまいません。通常は、生成されていないファイル用です。生成されたファイルの場合、通常は設定固有のパスの一部が含まれ、そのファイルのビルドに使用されたターゲット CPU アーキテクチャなどをエンコードしています。ファイルがバイナリの実行ファイル内にある場合は、ファイルをマッピングするパスとして short_path
を使用します。root
root File.rootこのファイルが存在するルート。
short_path
string File.short_pathこのファイルのルートからの相対パス。前述の root(パスの構成固有のフラグメント)は除外されます。ファイルがバイナリの実行ファイル内にある場合は、ファイルがマッピングされるパスでもあります。
tree_relative_path
string File.tree_relative_path祖先の is_directory フィールドが true の場合、祖先ツリーのルートを基準としたこのファイルの相対パス。
tree_relative_path
は、アクション コマンド内のディレクトリを展開したファイル(Args.add_all())でのみ使用できます。他のタイプのファイルの場合、このフィールドにアクセスするとエラーになります。