ファイル

問題を報告 ソースを表示 Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

このオブジェクトは、実行フェーズで読み取りまたは書き込みが行われるファイルまたはディレクトリを表すために、分析フェーズで作成されます。これは開いているファイル ハンドルではなく、ファイルの内容を直接読み書きするために使用することはできません。代わりに、アクション作成関数に渡すことで、ルール実装関数でアクション グラフを構築するために使用します。詳しくは、ルールページをご覧ください。

map_each 関数を使用せずに File が Args オブジェクトに渡されると、その path フィールドの値を取得して文字列に変換されます。

メンバー

basename

string File.basename

このファイルのベース名。これは、ディレクトリ内のファイルの名前です。

ディレクトリ名

string File.dirname

このファイルを含むディレクトリの名前。パスから取得され、常に実行ディレクトリを基準とする相対パスです。

拡張機能

string File.extension

このファイルの拡張子。右端のピリオドの後に続く（ピリオドは含まない）部分。ファイルのベース名にピリオドが含まれていない場合は空の文字列。

is_directory

bool File.is_directory

これがディレクトリの場合は true を返します。

is_source

bool File.is_source

これがソースファイル（生成されたものではない）の場合、true を返します。

オーナー

Label File.owner

このファイルを生成するターゲットのラベル。None を返すことがあります。

パス

string File.path

ワークスペースの実行ディレクトリを基準とした、このファイルの実行パス。これは、ルート（ルート モジュールも参照）と呼ばれるオプションの最初の部分と、short_path の 2 つの部分で構成されています。ルートは空の場合があります。通常、生成されていないファイルでは空になります。生成されたファイルの場合、通常は、そのファイルのビルドに使用されたターゲット CPU アーキテクチャなどの情報をエンコードする構成固有のパス フラグメントが含まれます。ファイルがバイナリの runfiles にある場合は、ファイルがマッピングされるパスに short_path を使用します。

root

root File.root

このファイルが配置されているルート。

short_path

string File.short_path

このファイルのルートからの相対パス。これは、前述の root（パスの構成固有のフラグメント）を除外します。これは、ファイルがバイナリの runfiles にある場合に、ファイルがマッピングされるパスでもあります。

tree_relative_path

string File.tree_relative_path

先祖の is_directory フィールドが true の場合、このファイルの先祖のツリーのルートからの相対パス。tree_relative_path は、アクション コマンド（Args.add_all() など）のディレクトリの展開されたファイルでのみ使用できます。他のタイプのファイルでこのフィールドにアクセスすると、エラーになります。