可在所有 Bazel 檔案中使用的函式,包括 .bzl 檔案、BUILD、MODULE.bazel、VENDOR.bazel 和 WORKSPACE。
成員
- abs
- all
- 任何
- bool
- dict
- dir
- enumerate
- 失敗
- float
- getattr
- hasattr
- hash
- int
- len
- 清單
- max
- min
- range
- repr
- 已撤銷
- 已排序
- str
- tuple
- type
- zip
abs
unknown abs(x)
abs(-2.3) == 2.3
參數
參數 | 說明 |
---|---|
x
|
int 或 float;
必填 (int 或 float) |
全部
bool all(elements)
all(["hello", 3, True]) == True all([-1, 0, 1]) == False
參數
參數 | 說明 |
---|---|
elements
|
必要 字串或元素集合。 |
不限
bool any(elements)
any([-1, 0, 1]) == True any([False, 0, ""]) == False
參數
參數 | 說明 |
---|---|
elements
|
必要 字串或元素集合。 |
bool
bool bool(x=False)
None
、False
、空字串 (""
)、數字 0
或空集合 (例如 ()
、[]
),則會傳回 False
。否則,會傳回 True
。
參數
參數 | 說明 |
---|---|
x
|
預設為 False 要轉換的變數。 |
dict
dict dict(pairs=[], **kwargs)
參數
參數 | 說明 |
---|---|
pairs
|
預設值為 [] 字典或可疊代元素,其元素每長度都為 2 (鍵、值)。 |
kwargs
|
required Additional 字典項目。 |
dir
list dir(x)
參數
參數 | 說明 |
---|---|
x
|
必要 要檢查的物件。 |
列舉
list enumerate(list, start=0)
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]
參數
參數 | 說明 |
---|---|
list
|
必要 輸入序列。 |
start
|
int;預設值為 0 的起始索引。 |
失敗
None
fail(msg=None, attr=None, sep=" ", *args)
參數
參數 | 說明 |
---|---|
msg
|
預設為 None 已淘汰:請改用位置引數。這個引數會做為隱含的領先位置引數。 |
attr
|
字串;或 None ;預設為 None 。已淘汰。會導致含有此字串的選用前置字串加入錯誤訊息。 |
sep
|
字串;
預設為 " " 。 物件之間的分隔字串,預設為空格 (" ")。 |
args
|
required 值清單,以 debugPrint 格式 (預設為 str) 顯示,並與 sep 連結 (預設為 " "),顯示在錯誤訊息中。 |
float
float float(x=unbound)
- 如果
x
已是浮點值,float
會以原值傳回。 - 如果
x
是布林值,float
會傳回 1.0 (代表 True) 和 0.0 (代表 False)。 - 如果
x
是 int,float
會傳回最接近 x 的有限浮點值,如果值太大,則會傳回錯誤。 - 如果
x
是字串,則必須是有效的浮點常值,或等於 (忽略大小寫)NaN
、Inf
或Infinity
,並可選擇在前方加上+
或-
符號。
float()
會傳回 0.0。
參數
參數 | 說明 |
---|---|
x
|
預設為 unbound 要轉換的值。 |
getattr
unknown getattr(x, name, default=unbound)
default
(如有指定) 或引發錯誤。getattr(x, "foobar")
等於 x.foobar
。getattr(ctx.attr, "myattr") getattr(ctx.attr, "myattr", "mydefault")
參數
參數 | 說明 |
---|---|
x
|
required 屬性存取的結構體。 |
name
|
string;
必要 結構體屬性的名稱。 |
default
|
預設為 unbound 如果結構體沒有指定名稱的屬性,則會傳回預設值。 |
hasattr
bool hasattr(x, name)
x
具有指定 name
的屬性或方法,則傳回 True,否則傳回 False。範例:hasattr(ctx.attr, "myattr")
參數
參數 | 說明 |
---|---|
x
|
必要 要檢查的物件。 |
name
|
string;
required 屬性名稱。 |
hash
int hash(value)
String.hashCode()
相同的演算法,以確定性方式計算此值,具體為:s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
參數
參數 | 說明 |
---|---|
value
|
string;
必要 要進行雜湊運算的字串值。 |
int
int int(x, base=unbound)
- 如果
x
已經是 int,int
會傳回不變。 - 如果
x
是布林值,int
會傳回 1 代表 True,傳回 0 代表 False。 - 如果
x
是字串,則格式必須為<sign><prefix><digits>
。<sign>
可以是"+"
、"-"
或空白 (視為正值)。<digits>
是從 0 到base
- 1 的數字序列,其中英文字母 a-z (或同等的 A-Z) 用於 10 到 35 的數字。在base
為 2/8/16 的情況下,<prefix>
為選用項目,分別為 0b/0o/0x (或同等的值為 0B/0O/0X);如果base
是這些底數或特殊值 0 以外的任何其他值,則前置碼必須留空。如果base
為 0,字串會解讀為整數字面值,也就是會依據使用前置字元 (如有) 選擇 2/8/10/16 等其中一個基底。如果base
為 0,則不使用前置字元,而超過一個數字,開頭的數字不得為 0;這是為了避免八進位和小數混淆。字串所代表的數字大小必須落在 int 類型的允許範圍內。 - 如果
x
是浮點值,int
會傳回浮點值的整數值,並四捨五入至零。如果 x 是非有限值 (NaN 或無限大),則會發生錯誤。
x
是任何其他類型,或是值是字串但不符合上述格式,則此函式會失敗。與 Python 的 int
函式不同,這個函式不允許零引數,且不允許字串引數使用多餘的空白字元。範例:
int("123") == 123 int("-123") == -123 int("+123") == 123 int("FF", 16) == 255 int("0xFF", 16) == 255 int("10", 0) == 10 int("-0x10", 0) == -16 int("-0x10", 0) == -16 int("123.456") == 123
參數
參數 | 說明 |
---|---|
x
|
必填 要轉換的字串。 |
base
|
預設值為 unbound 用來解譯字串值的基礎,預設值為 10。必須介於 2 和 36 (含) 之間,或設為 0 以便偵測 x 是否為整數運算式。如果值不是字串,則不得提供此參數。 |
len
int len(x)
參數
參數 | 說明 |
---|---|
x
|
required 要回報長度的值。 |
list
list list(x=[])
list([1, 2]) == [1, 2] list((2, 3, 2)) == [2, 3, 2] list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]
參數
參數 | 說明 |
---|---|
x
|
可迭代;
預設為 [] 要轉換的物件。 |
最高
unknown max(key=None, *args)
max(2, 5, 4) == 5 max([5, 6, 3]) == 6 max("two", "three", "four", key = len) =="three" # the longest max([1, -1, -2, 2], key = abs) == -2 # the first encountered with maximal key value
參數
參數 | 說明 |
---|---|
key
|
可呼叫;或 None ;
預設為 None 在比較前套用至每個元素的選用函式。 |
args
|
required 要檢查的元素。 |
分鐘
unknown min(key=None, *args)
min(2, 5, 4) == 2 min([5, 6, 3]) == 3 min("six", "three", "four", key = len) == "six" # the shortest min([2, -2, -1, 1], key = abs) == -1 # the first encountered with minimal key value
參數
參數 | 說明 |
---|---|
key
|
可呼叫;或 None ;
預設為 None 在比較前套用至每個元素的選用函式。 |
args
|
required 要檢查的元素。 |
列印
None
print(sep=" ", *args)
args
列印為偵錯輸出內容。並在前面加上 "DEBUG"
字串和這個呼叫的位置 (檔案和行號)。未指定引數轉換為字串的確切方式,而且可能隨時變更。特別是,這可能與 str()
和 repr()
所執行的格式不同 (且更為詳細)。我們不建議在正式版程式碼中使用 print
,因為這個程式碼會向使用者顯示垃圾內容。針對淘汰項目,請盡可能使用 fail()
產生嚴重錯誤。
參數
參數 | 說明 |
---|---|
sep
|
字串;
預設為 " " 。 物件之間的分隔字串,預設為空格 (" ")。 |
args
|
必要 要列印的物件。 |
範圍
sequence range(start_or_stop, stop_or_none=None, step=1)
step
遞增值,建立從 start
到 stop
的項目清單。如果提供單一引數,項目的範圍從 0 到該元素。range(4) == [0, 1, 2, 3] range(3, 9, 2) == [3, 5, 7] range(3, 0, -1) == [3, 2, 1]
參數
參數 | 說明 |
---|---|
start_or_stop
|
int;
必要 如果提供 stop,則為 start 元素的值;否則,stop 和實際開始值為 0 |
stop_or_none
|
int; 或 None ;預設值為 None ,第一個項目的選用索引「不會」包含在結果清單中;清單會在到達 stop 前停止。 |
step
|
int;預設為 1 。增量值 (預設為 1)。可能為負值。 |
Repr
string repr(x)
repr("ab") == '"ab"'
參數
參數 | 說明 |
---|---|
x
|
必填 要轉換的物件。 |
已反轉
list reversed(sequence)
reversed([3, 5, 4]) == [4, 5, 3]
參數
參數 | 說明 |
---|---|
sequence
|
iterable;
required 要反轉的可枚舉序列 (例如清單)。 |
sorted
list sorted(iterable, key=None, *, reverse=False)
sorted([3, 5, 4]) == [3, 4, 5] sorted([3, 5, 4], reverse = True) == [5, 4, 3] sorted(["two", "three", "four"], key = len) == ["two", "four", "three"] # sort by length
參數
參數 | 說明 |
---|---|
iterable
|
iterable;
required 要排序的可迭代序列。 |
key
|
可呼叫;或 None ;
預設為 None 在比較前套用至每個元素的選用函式。 |
reverse
|
bool;預設值為 False 以遞減順序傳回結果。 |
str
string str(x)
str("ab") == "ab" str(8) == "8"
參數
參數 | 說明 |
---|---|
x
|
必填 要轉換的物件。 |
元組
tuple tuple(x=())
tuple([1, 2]) == (1, 2) tuple((2, 3, 2)) == (2, 3, 2) tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)
參數
參數 | 說明 |
---|---|
x
|
可列舉項目;
預設為 () 要轉換的物件。 |
類型
string type(x)
type(2) == "int" type([1]) == "list" type(struct(a = 2)) == "struct"
if type(x) == type([]): # if x is a list
參數
參數 | 說明 |
---|---|
x
|
必要 要檢查類型的物件。 |
zip
list zip(*args)
tuple
的 list
,其中第 i 個元組包含各個引數序列或可枚舉項目的第 i 個元素。清單的大小與最短輸入內容相同。使用單一可枚舉引數時,會傳回 1 元組的清單。如果不使用引數,就會傳回空白清單。範例:zip() # == [] zip([1, 2]) # == [(1,), (2,)] zip([1, 2], [3, 4]) # == [(1, 3), (2, 4)] zip([1, 2], [3, 4, 5]) # == [(1, 3), (2, 4)]
參數
參數 | 說明 |
---|---|
args
|
將必要的 清單壓縮成 ZIP 檔案。 |