此对象在分析阶段创建,用于表示将在执行阶段读取或写入的文件或目录。它不是打开的文件句柄,无法用于直接读取或写入文件内容。而是通过将其传递给用于创建操作的函数,在规则实现函数中使用它来构建操作图。如需了解详情,请参阅“规则”页面。
如果在不使用 map_each
函数的情况下将 File
传递给 Args
对象,系统会通过获取其 path
字段的值将其转换为字符串。
成员
基名
string File.basename
dirname
string File.dirname
扩展程序
string File.extension
is_directory
bool File.is_directory
is_source
bool File.is_source
所有者
Label File.owner
None
。
路径
string File.path
short_path
。根目录可能为空,通常是针对非生成的文件。对于生成的文件,它通常包含特定于配置的路径片段,用于编码构建该文件时所用的目标 CPU 架构等内容。如果文件位于二进制文件的 runfile 中,请使用 short_path
作为该文件的映射路径。
root
root File.root
short_path
string File.short_path
tree_relative_path
string File.tree_relative_path
tree_relative_path
仅适用于操作命令(即 Args.add_all())中目录的展开文件。对于其他类型的文件,访问此字段会出错。