ファイル

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

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

メンバー

• basename
• dirname
• extension
• is_directory
• is_source
• owner
• path
• root
• short_path
• tree_relative_path

basename

string File.basename

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

dirname

string File.dirname

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

extension

string File.extension

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

is_directory

bool File.is_directory

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

is_source

bool File.is_source

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

owner

Label File.owner

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

path

string File.path

ワークスペースの実行ディレクトリからの相対パスで表した、このファイルの実行パス。2 つの部分で構成されます。1 つ目は省略可能な「ルート」（ルート モジュールも参照）で、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()）でのみ使用できます。他のタイプのファイルの場合、このフィールドにアクセスするとエラーになります。