模板 Dict

7.3 · 7.2 · 7.1 · 7.0 · 6.5

在 ctx.actions.expand_template() 中使用的类似 Args 的结构，允许将值的评估延迟到执行阶段。

成员

TemplateDict TemplateDict.add(key, value)

添加字符串值

参数	说明
`key`	必需字符串键
`value`	必需字符串值

TemplateDict TemplateDict.add_joined(key, values, *, join_with, map_each, uniquify=False, format_joined=None, allow_closure=False)

添加值的 depset

参数	说明
`key`	必需一个字符串键
`values`	depset；必需要联接的项所在的 depset。
`join_with`	必需用于联接通过应用 `map_each` 获得的字符串的分隔符字符串，方式与 `string.join()` 相同。
`map_each`	Callable；必需一个 Starlark 函数，接受单个参数并返回字符串、`None` 或字符串列表。此函数会应用于 `values` 参数中指定的 depset 的每个项
`uniquify`	默认值为 `False` 如果为 true，系统会忽略派生自 `values` 的重复字符串。系统只会保留每个字符串的首次出现。通常不需要此功能，因为 depset 已省略重复项，但如果 `map_each` 为多个项发出了相同的字符串，则此功能会很有用。
`format_joined`	字符串；或 `None`；默认为 `None` 应用于连接字符串的可选格式字符串模式。格式字符串必须且只能包含一个“%s”占位符。
`allow_closure`	默认值为 `False` 如果为 true，则允许在函数参数（如 `map_each`）中使用闭包。通常情况下，这并不必要，并且可能会导致在执行阶段保留分析阶段的大型数据结构。