文件

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
此对象在分析阶段创建,表示要在执行阶段读取或写入的文件或目录。它不是打开的文件句柄,并且无法直接读取或写入文件内容。相反,您可以使用它通过将操作图传递给操作创建函数,在规则实现函数中构造该操作图。如需了解详情,请参阅“规则”页面

File会传递到Args对象,而不使用map_each函数时,系统会将其字符串的值作为字符串转换为字符串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,也就是说,它不会生成。

owner

Label File.owner

生成此文件的目标的标签。 可能会返回 None

路径

string File.path

此文件的执行路径(相对于工作区的执行目录)。它包含两个部分,可选的第一部分称为根级(另请参阅根级模块),而第二部分则是short_path。根目录可能为空,这通常用于非生成的文件。对于生成的文件,它通常包含一个特定于配置的路径片段,该片段会对构建该文件时使用的目标 CPU 架构等内容进行编码。如果文件位于二进制文件的运行文件中,则使用 short_path 作为文件映射路径。

root File.root

此文件所在的根节点。

短路径

string File.short_path

此文件的路径相对于其根目录。这不包括前面提到的根,即路径中特定于配置的片段。如果该文件位于二进制文件的运行文件中,则该文件将作为其映射路径。

树相对路径

string File.tree_relative_path

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