類似 Args 的結構,可用於 ctx.actions.expand_template(),可將值的評估作業延後至執行階段。
成員
add
TemplateDict TemplateDict.add(key, value)
參數
參數 | 說明 |
---|---|
key
|
string;
必要 String 鍵 |
value
|
string;
必填 String 值 |
add_joined
TemplateDict TemplateDict.add_joined(key, values, *, join_with, map_each, uniquify=False, format_joined=None, allow_closure=False)
參數
參數 | 說明 |
---|---|
key
|
string;
必要 String 鍵 |
values
|
depset;
必填 depset 的項目將會加入。 |
join_with
|
string;
必要 用於將透過套用 map_each 取得的字串連結在一起的分隔符號字串,與 string.join() 的做法相同。
|
map_each
|
callable;
required Starlark 函式,可接受單一引數,並傳回字串、 None 或字串清單。這個函式會套用至 values 參數中指定的 depset 的每個項目
|
uniquify
|
bool;
預設為 False 如果為 true,系統會略過 values 衍生的重複字串。只保留每個字串的第一次出現。通常不需要這項功能,因為 depset 已略過重複項目,但如果 map_each 為多個項目傳出相同的字串,這項功能就很實用。 |
format_joined
|
字串或 None ;預設為 None 。 (選用) 套用至已彙整字串的格式字串模式。格式字串中只能有一個「%s」預留位置。 |
allow_closure
|
bool;
預設為 False 如果為 true,則允許在 map_each 等函式參數中使用閉包。這通常並非必要,而且可能會導致在執行階段保留大量分析階段資料結構。 |