Các phương thức có trong tất cả tệp Bazel, bao gồm cả tệp .bzl, BUILD, MODULE.bazel, VENDOR.bazel và WORKSPACE.
Hội viên
- abs
- tất cả
- bất kỳ
- bool
- dict
- dir
- enumerate
- không đạt
- float
- getattr
- hasattr
- hàm băm
- int
- len
- list
- max
- phút
- dải ô
- repr
- đã huỷ
- set
- đã sắp xếp
- str
- tuple
- type
- zip
abs
unknown abs(x)
abs(-2.3) == 2.3
Tham số
| Thông số | Mô tả |
|---|---|
x
|
int; hoặc float;
bắt buộc Một số (int hoặc float) |
tất cả
bool all(elements)
all(["hello", 3, True]) == True all([-1, 0, 1]) == False
Tham số
| Thông số | Mô tả |
|---|---|
elements
|
bắt buộc Một chuỗi hoặc tập hợp các phần tử. |
bất kỳ
bool any(elements)
any([-1, 0, 1]) == True any([False, 0, ""]) == False
Tham số
| Thông số | Mô tả |
|---|---|
elements
|
bắt buộc Một chuỗi hoặc tập hợp các phần tử. |
bool
bool bool(x=False)
False nếu đối tượng là None, False, một chuỗi trống (""), số 0 hoặc một tập hợp trống (ví dụ: (), []). Nếu không, phương thức này sẽ trả về True.
Tham số
| Thông số | Mô tả |
|---|---|
x
|
mặc định là FalseBiến cần chuyển đổi. |
dict
dict dict(pairs=[], **kwargs)
Tham số
| Thông số | Mô tả |
|---|---|
pairs
|
mặc định là []Một dict hoặc một đối tượng có thể lặp lại, trong đó mỗi phần tử có độ dài 2 (khoá, giá trị). |
kwargs
|
bắt buộc Từ điển của các mục bổ sung. |
dir
list dir(x)
Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Đối tượng cần kiểm tra. |
liệt kê
list enumerate(list, start=0)
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]
Tham số
| Thông số | Mô tả |
|---|---|
list
|
trình tự đầu vào bắt buộc. |
start
|
int;
mặc định là 0chỉ mục bắt đầu. |
không thành công
None fail(msg=None, attr=None, sep=" ", *args)Tham số
| Thông số | Mô tả |
|---|---|
msg
|
mặc định là NoneKhông dùng nữa: hãy sử dụng đối số vị trí. Đối số này hoạt động như một đối số vị trí đầu tiên ngầm ẩn. |
attr
|
chuỗi; hoặc None;
mặc định là NoneKhông dùng nữa. Thêm một tiền tố không bắt buộc chứa chuỗi này vào thông báo lỗi. |
sep
|
string; giá trị mặc định là " "Chuỗi phân cách giữa các đối tượng, giá trị mặc định là dấu cách (" "). |
args
|
bắt buộc Danh sách các giá trị, được định dạng bằng debugPrint (tương đương với str theo mặc định) và được nối với sep (mặc định là " "), xuất hiện trong thông báo lỗi. |
số thực dấu phẩy động
float float(x=unbound)
- Nếu
xđã là một float,floatsẽ trả về giá trị đó mà không thay đổi. - Nếu
xlà một bool,floatsẽ trả về 1.0 cho True và 0.0 cho False. - Nếu
xlà một int,floatsẽ trả về giá trị dấu phẩy động hữu hạn gần nhất với x hoặc một lỗi nếu độ lớn quá lớn. - Nếu
xlà một chuỗi, thì chuỗi đó phải là một giá trị cố định kiểu dấu phẩy động hợp lệ hoặc bằng (bỏ qua chữ hoa chữ thường) vớiNaN,InfhoặcInfinity, có thể có dấu+hoặc-đứng trước.
float() sẽ trả về 0.0.
Tham số
| Thông số | Mô tả |
|---|---|
x
|
mặc định là unboundGiá trị cần chuyển đổi. |
getattr
unknown getattr(x, name, default=unbound)
default (nếu được chỉ định) hoặc báo lỗi. getattr(x, "foobar") tương đương với x.foobar.getattr(ctx.attr, "myattr") getattr(ctx.attr, "myattr", "mydefault")
Tham số
| Thông số | Mô tả |
|---|---|
x
|
required Cấu trúc có thuộc tính được truy cập. |
name
|
string;
bắt buộc Tên của thuộc tính cấu trúc. |
default
|
mặc định là unboundGiá trị mặc định được trả về trong trường hợp cấu trúc không có thuộc tính của tên đã cho. |
hasattr
bool hasattr(x, name)
x có thuộc tính hoặc phương thức của name đã cho, nếu không thì trả về False. Ví dụ:hasattr(ctx.attr, "myattr")
Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Đối tượng cần kiểm tra. |
name
|
string;
bắt buộc Tên của thuộc tính. |
hàm băm
int hash(value)
String.hashCode() của Java, cụ thể là: s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
Tham số
| Thông số | Mô tả |
|---|---|
value
|
string;
bắt buộc Giá trị chuỗi để băm. |
int
int int(x, base=unbound)
- Nếu
xđã là một int,intsẽ trả về giá trị đó mà không thay đổi. - Nếu
xlà một bool,intsẽ trả về 1 cho True và 0 cho False. - Nếu
xlà một chuỗi, thì chuỗi đó phải có định dạng<sign><prefix><digits>.<sign>là"+","-"hoặc trống (được diễn giải là dương).<digits>là một chuỗi chữ số từ 0 đếnbase– 1, trong đó các chữ cái a-z (hoặc tương đương là A-Z) được dùng làm chữ số cho 10-35. Trong trường hợpbaselà 2/8/16,<prefix>là không bắt buộc và có thể là 0b/0o/0x (hoặc tương đương là 0B/0O/0X) tương ứng; nếubaselà bất kỳ giá trị nào khác ngoài các cơ sở này hoặc giá trị đặc biệt 0, thì tiền tố phải trống. Trong trường hợpbaselà 0, chuỗi được diễn giải là một số nguyên cố định, theo nghĩa là một trong các cơ sở 2/8/10/16 được chọn tuỳ thuộc vào tiền tố nào được sử dụng (nếu có). Nếubaselà 0, không có tiền tố nào được sử dụng và có nhiều chữ số, thì chữ số đầu tiên không được là 0; điều này là để tránh nhầm lẫn giữa số bát phân và số thập phân. Độ lớn của số được biểu thị bằng chuỗi phải nằm trong phạm vi cho phép của kiểu int. - Nếu
xlà một số thực,intsẽ trả về giá trị số nguyên của số thực đó, làm tròn về 0. Đây là lỗi nếu x không phải là số hữu hạn (NaN hoặc vô cực).
x là loại khác hoặc nếu giá trị là một chuỗi không đáp ứng định dạng ở trên. Không giống như hàm int của Python, hàm này không cho phép đối số rỗng và không cho phép khoảng trắng thừa cho đối số chuỗi.Ví dụ:
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
Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Chuỗi cần chuyển đổi. |
base
|
mặc định là unboundCơ sở dùng để diễn giải giá trị chuỗi; mặc định là 10. Phải nằm trong khoảng từ 2 đến 36 (bao gồm cả 2 và 36) hoặc 0 để phát hiện cơ số như thể x là một số nguyên cố định. Bạn không được cung cấp thông số này nếu giá trị không phải là một chuỗi.
|
len
int len(x)
Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Giá trị có độ dài cần báo cáo. |
danh sách
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]Tham số
| Thông số | Mô tả |
|---|---|
x
|
iterable;
mặc định là []Đối tượng cần chuyển đổi. |
tối đa
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
Tham số
| Thông số | Mô tả |
|---|---|
key
|
callable; hoặc None;
mặc định là NoneMột hàm không bắt buộc được áp dụng cho mỗi phần tử trước khi so sánh. |
args
|
bắt buộc Các phần tử cần kiểm tra. |
phút
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
Tham số
| Thông số | Mô tả |
|---|---|
key
|
callable; hoặc None;
mặc định là NoneMột hàm không bắt buộc được áp dụng cho mỗi phần tử trước khi so sánh. |
args
|
bắt buộc Các phần tử cần kiểm tra. |
in
None print(sep=" ", *args)args dưới dạng kết quả gỡ lỗi. Chuỗi này sẽ có tiền tố là chuỗi "DEBUG" và vị trí (tệp và số dòng) của lệnh gọi này. Cách chính xác để chuyển đổi các đối số thành chuỗi không được chỉ định và có thể thay đổi bất cứ lúc nào. Cụ thể, định dạng này có thể khác với (và chi tiết hơn) định dạng do str() và repr() thực hiện.Bạn không nên sử dụng print trong mã phát hành công khai do mã này tạo ra nội dung rác cho người dùng. Đối với các tính năng không dùng nữa, hãy ưu tiên lỗi nghiêm trọng bằng cách sử dụng fail() bất cứ khi nào có thể.
Tham số
| Thông số | Mô tả |
|---|---|
sep
|
string; giá trị mặc định là " "Chuỗi phân cách giữa các đối tượng, giá trị mặc định là dấu cách (" "). |
args
|
bắt buộc Các đối tượng cần in. |
phạm vi
sequence range(start_or_stop, stop_or_none=None, step=1)
start đến stop, sử dụng giá trị tăng step. Nếu bạn chỉ cung cấp một đối số, các mục sẽ nằm trong khoảng từ 0 đến phần tử đó.range(4) == [0, 1, 2, 3] range(3, 9, 2) == [3, 5, 7] range(3, 0, -1) == [3, 2, 1]
Tham số
| Thông số | Mô tả |
|---|---|
start_or_stop
|
int;
bắt buộc Giá trị của phần tử bắt đầu nếu bạn cung cấp giá trị dừng, nếu không giá trị của phần tử dừng và giá trị bắt đầu thực tế là 0 |
stop_or_none
|
int; hoặc None; giá trị mặc định là Nonechỉ mục không bắt buộc của mục đầu tiên không được đưa vào danh sách kết quả; quá trình tạo danh sách sẽ dừng trước khi đạt đến stop.
|
step
|
int;
mặc định là 1Số tăng (mặc định là 1). Có thể là giá trị âm. |
repr
string repr(x)
repr("ab") == '"ab"'Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Đối tượng cần chuyển đổi. |
đã đảo ngược
list reversed(sequence)
reversed([3, 5, 4]) == [4, 5, 3]
Tham số
| Thông số | Mô tả |
|---|---|
sequence
|
iterable;
bắt buộc Trình tự có thể lặp lại (ví dụ: danh sách) cần đảo ngược. |
đặt
set set(elements=[])
--experimental_enable_starlark_set.
Tạo một set mới, có thể được khởi tạo để chứa các phần tử từ một iterable nhất định.
Tham số
| Thông số | Mô tả |
|---|---|
elements
|
mặc định là []Một tập hợp, trình tự hoặc từ điển. |
đã sắp xếp
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
Tham số
| Thông số | Mô tả |
|---|---|
iterable
|
iterable;
bắt buộc Trình tự có thể lặp lại để sắp xếp. |
key
|
callable; hoặc None;
mặc định là NoneMột hàm không bắt buộc được áp dụng cho mỗi phần tử trước khi so sánh. |
reverse
|
bool; giá trị mặc định là FalseTrả về kết quả theo thứ tự giảm dần. |
str
string str(x)
str("ab") == "ab"
str(8) == "8"Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Đối tượng cần chuyển đổi. |
bộ dữ liệu
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)Tham số
| Thông số | Mô tả |
|---|---|
x
|
iterable;
mặc định là ()Đối tượng cần chuyển đổi. |
loại
string type(x)
type(2) == "int" type([1]) == "list" type(struct(a = 2)) == "struct"
if type(x) == type([]): # if x is a list
Tham số
| Thông số | Mô tả |
|---|---|
x
|
bắt buộc Đối tượng cần kiểm tra loại. |
zip
list zip(*args)
list của tuple, trong đó cặp thứ i chứa phần tử thứ i từ mỗi trình tự đối số hoặc đối tượng có thể lặp lại. Danh sách có kích thước bằng dữ liệu đầu vào ngắn nhất. Với một đối số có thể lặp lại, hàm này sẽ trả về một danh sách gồm 1-tuple. Nếu không có đối số, hàm này sẽ trả về một danh sách trống. Ví dụ: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)]
Tham số
| Thông số | Mô tả |
|---|---|
args
|
danh sách bắt buộc để nén. |