对于每个 Label 实例 l，字符串表示法 str(l) 具有 Label(str(l)) == l 属性，无论 Label() 调用出现在何处。
当作为位置实参传递给 print() 或 fail() 时，Label 会改用针对人类可读性进行优化的字符串表示法。如果可能，此表示法会从主代码库的角度使用明显的代码库名称。
成员
Label
Label Label(input)
.bzl 源文件所在的软件包的上下文中，将标签字符串转换为 Label 对象。如果给定值已是 Label，则会原封不动地返回。对于宏，相关函数 native.package_relative_label() 会在当前构建的软件包的上下文中将输入转换为 Label。使用该函数来模拟标签值规则属性自动执行的字符串到标签转换。
参数
| 参数 | 说明 |
|---|---|
input
|
字符串；或 Label；
必需 输入标签字符串或 Label 对象。如果传递了 Label 对象，则会原封不动地返回。 |
name
string Label.name
Label("@@foo//pkg/foo:abc").name == "abc"package
string Label.package
Label("@@repo//pkg/foo:abc").package == "pkg/foo"relative
Label Label.relative(relName)
--+incompatible_enable_deprecated_label_apis 以实验方式启用此功能。当与包含明显代码库名称的实参一起使用时，此方法的行为令人意外。请改用
Label.same_package_label()、native.package_relative_label() 或 Label()。解析绝对标签（以 // 开头）或相对于当前软件包的标签。如果此标签位于远程代码库中，则实参将相对于该代码库进行解析。如果实参包含代码库名称，则当前标签将被忽略，并且实参将原封不动地返回，但如果代码库名称位于当前代码库映射中，则会重写该名称。保留标签也会原封不动地返回。
例如：
Label("//foo/bar:baz").relative(":quux") == Label("//foo/bar:quux")
Label("//foo/bar:baz").relative("//wiz:quux") == Label("//wiz:quux")
Label("@repo//foo/bar:baz").relative("//wiz:quux") == Label("@repo//wiz:quux")
Label("@repo//foo/bar:baz").relative("//visibility:public") == Label("//visibility:public")
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@other//wiz:quux")
如果传入的代码库映射为 {'@other' : '@remapped'}，则会发生以下重新映射：
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
参数
| 参数 | 说明 |
|---|---|
relName
|
字符串；
必需 将相对于此标签解析的标签。 |
repo_name
string Label.repo_name
@)。例如，Label("@@foo//bar:baz").repo_name == "foo"same_package_label
Label Label.same_package_label(target_name)
参数
| 参数 | 说明 |
|---|---|
target_name
|
字符串；
必需 新标签的目标名称。 |
workspace_name
string Label.workspace_name
--+incompatible_enable_deprecated_label_apis 以实验方式启用此功能。字段名称“工作区名称”在此处用词不当；请改用行为相同的
Label.repo_name。包含此标签引用的目标的代码库的规范名称，不包含任何前导 at 符号 (@)。例如，
Label("@@foo//bar:baz").workspace_name == "foo"workspace_root
string Label.workspace_root
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"