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