類似 Args 的結構,可用於 ctx.actions.expand_template(),可將值的評估作業延後至執行階段。
成員
add
TemplateDict TemplateDict.add(key, value)
參數
參數 | 說明 |
---|---|
key
|
string;必要
字串鍵 |
value
|
string;必要
字串值 |
add_joined
TemplateDict TemplateDict.add_joined(key, values, *, join_with, map_each, uniquify=False, format_joined=None, allow_closure=False)
參數
參數 | 說明 |
---|---|
key
|
string;必要
字串鍵 |
values
|
depset;
required 要合併項目的 depset。 |
join_with
|
string;必要
用於合併套用 map_each 所得字串的分隔符號字串,方式與 string.join() 相同。
|
map_each
|
callable;
required A Starlark function accepting a single argument and returning either a string, None , or a list of strings. 這個函式會套用至 values 參數中指定的每個 depset 項目
|
uniquify
|
bool;預設值為 False 如果為 true,系統會省略從 values 衍生的重複字串。系統只會保留每個字串第一次出現的項目。通常不需要這項功能,因為依附元件集已省略重複項目,但如果 map_each 為多個項目發出相同字串,這項功能就很有用。
|
format_joined
|
string;或 None ;預設值為 None 。套用至已聯結字串的選用格式字串模式。格式字串只能有一個「%s」預留位置。 |
allow_closure
|
bool;預設為 False 。如果為 true,則允許在函式參數中使用閉包,例如 map_each 。通常不需要這麼做,而且可能會在執行階段保留大型分析階段資料結構。
|