ファイル

問題を報告 ソースを表示

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

Filemap_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())でのみ使用できます。他の種類のファイルでは、このフィールドにアクセスするとエラーが発生します。