文件

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
报告问题 查看源代码

此对象是在分析阶段创建的，用于表示要在执行阶段读取或写入的文件或目录。它不是一个开放文件句柄，不能用于直接读取或写入文件内容。相反，您可以使用该对象通过将操作图传递给操作创建函数，在其中构建操作图。如需了解详情，请参阅“规则”页面。

如果在不使用 map_each 函数的情况下将 File 传递给 Args 对象，系统会通过获取其 path 字段的值来将该字符串转换为字符串。

会员

基名

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

此文件的执行路径（相对于工作区的执行目录）。它包含两个部分，第一部分称为 root（也称为根模块），第二部分是 short_path。根目录可能为空，通常针对未生成的文件。对于生成的文件，该文件通常包含特定于配置的路径 fragment，用于对构建上述文件时所使用的目标 CPU 架构等内容进行编码。如果文件位于二进制文件的运行文件中，请使用 short_path 作为映射文件路径。

root

root File.root

此文件所在的根目录。

短路径

string File.short_path

此文件相对于根目录的路径。这排除了上述根，即路径中特定于配置的 fragment。如果该文件位于二进制文件的运行文件中，则此文件也会通过此路径进行映射。

相对路径

string File.tree_relative_path

此文件相对于祖先树的根目录的路径（如果祖先的 is_directory 字段为 true）。tree_relative_path 仅适用于操作命令中目录的展开后文件，即 Args.add_all()。对于其他类型的文件，访问此字段会出错。