ファイル

問題を報告する ソースを表示

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

map_each 関数を使用せずに FileArgs オブジェクトに渡されると、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 つの部分から構成されています。rootroot モジュールも参照)と呼ばれる最初の部分(省略可)と、2 番目の部分(short_path)です。ルートは空にすることもできますが、通常は生成されていないファイルに使用します。生成されたファイルには、通常、そのファイルのビルド時に使用されたターゲット CPU アーキテクチャなどをエンコードした構成固有のパス フラグメントが含まれます。ファイルがバイナリのランファイル内にある場合は、ファイルがマッピングされるパスに short_path を使用します。

root

root File.root

このファイルが存在するルート。

short_path

string File.short_path

このファイルのパス(ルートからの相対パス)。これには、前述のルート(パスの構成固有のフラグメント)は含まれません。ファイルがバイナリのランファイル内にある場合、このパスはマッピングされるパスでもあります。

tree_relative_path

string File.tree_relative_path

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