เมธอดที่ใช้ได้ในไฟล์ Bazel ทั้งหมด ซึ่งรวมถึงไฟล์ .bzl, BUILD, MODULE.bazel, VENDOR.bazel และ WORKSPACE
สมาชิก
- abs
- all
- any
- bool
- dict
- dir
- enumerate
- fail
- float
- getattr
- hasattr
- hash
- int
- len
- list
- max
- นาที
- range
- repr
- reversed
- set
- จัดเรียง
- 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(x=False)
False หากออบเจ็กต์คือ None, False, สตริงว่าง (""), ตัวเลข 0 หรือคอลเล็กชันว่าง (เช่น (), []) มิเช่นนั้นระบบจะแสดงผล True
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
ค่าเริ่มต้นคือ Falseตัวแปรที่จะแปลง |
dict
dict dict(pairs=[], **kwargs)
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
pairs
|
ค่าเริ่มต้นคือ []Dict หรือรายการที่วนซ้ำได้ซึ่งมีองค์ประกอบแต่ละรายการมีความยาว 2 (คีย์ ค่า) |
kwargs
|
required คําจํากัดความของรายการเพิ่มเติม |
dir
list dir(x)
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบ |
แจกแจง
list enumerate(list, start=0)
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
list
|
ต้องใช้ ลำดับอินพุต |
start
|
int;
ค่าเริ่มต้นคือ 0start index |
ล้มเหลว
None fail(msg=None, attr=None, sep=" ", *args)พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
msg
|
ค่าเริ่มต้นคือ Noneเลิกใช้งานแล้ว: ใช้อาร์กิวเมนต์ตำแหน่งแทน อาร์กิวเมนต์นี้จะทํางานเหมือนอาร์กิวเมนต์ตําแหน่งหน้าแบบนัย |
attr
|
สตริง หรือ None
ค่าเริ่มต้นคือ Noneเลิกใช้งานแล้ว ทําให้ระบบเพิ่มคำนำหน้า (ไม่บังคับ) ที่มีสตริงนี้ลงในข้อความแสดงข้อผิดพลาด |
sep
|
สตริง;
ค่าเริ่มต้นคือ " "ซึ่งเป็นสตริงตัวคั่นระหว่างออบเจ็กต์ โดยค่าเริ่มต้นคือเว้นวรรค (" ") |
args
|
required ลิสต์ค่าที่มีการจัดรูปแบบด้วย debugPrint (ซึ่งเทียบเท่ากับ str โดยค่าเริ่มต้น) และต่อด้วย sep (ค่าเริ่มต้นคือ " ") ซึ่งปรากฏในข้อความแสดงข้อผิดพลาด |
จำนวนลอยตัว
float float(x=unbound)
- หาก
xเป็นตัวเลขทศนิยมอยู่แล้วfloatจะแสดงผลโดยไม่เปลี่ยนแปลง - หาก
xเป็นบูลีนfloatจะแสดงผล 1.0 สำหรับ True และ 0.0 สำหรับ False - หาก
xเป็น intfloatจะแสดงผลค่าทศนิยมที่มีค่าจำกัดซึ่งใกล้เคียงที่สุดกับ x หรือแสดงข้อผิดพลาดหากค่าสัมบูรณ์มีขนาดใหญ่เกินไป - หาก
xเป็นสตริง สตริงดังกล่าวต้องเป็นค่าคงที่ทศนิยมที่ถูกต้อง หรือเท่ากับ (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่)NaN,InfหรือInfinityโดยอาจนำหน้าด้วยเครื่องหมาย+หรือ-
float() จะแสดงผลเป็น 0.0
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
ค่าเริ่มต้นคือ unboundค่าที่จะแปลง |
getattr
unknown getattr(x, name, default=unbound)
default (หากระบุไว้) หรือแสดงข้อผิดพลาด getattr(x, "foobar") มีค่าเท่ากับ x.foobargetattr(ctx.attr, "myattr") getattr(ctx.attr, "myattr", "mydefault")
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
required สตรัคเจอร์ที่มีการเข้าถึงแอตทริบิวต์ |
name
|
string;
ต้องระบุ ชื่อแอตทริบิวต์ Struct |
default
|
default is unboundค่าเริ่มต้นที่จะแสดงในกรณีที่โครงสร้างไม่มีแอตทริบิวต์ของชื่อที่ระบุ |
hasattr
bool hasattr(x, name)
x มีแอตทริบิวต์หรือเมธอดของ name ที่ระบุ มิเช่นนั้นแสดงผลเป็น "เท็จ" ตัวอย่าง:hasattr(ctx.attr, "myattr")
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบ |
name
|
สตริง;
ต้องระบุ ชื่อแอตทริบิวต์ |
แฮช
int hash(value)
String.hashCode() ของ Java ดังนี้ 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 สำหรับ "จริง" และ 0 สำหรับ "เท็จ" - หาก
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 ระบบจะไม่ใช้คำนำหน้า และหากมีตัวเลขมากกว่า 1 ตัว ตัวเลขนำหน้าต้องไม่ใช่ 0 ทั้งนี้เพื่อไม่ให้เกิดความสับสนระหว่างฐาน 8 กับฐาน 10 ขนาดของตัวเลขที่แสดงโดยสตริงต้องอยู่ภายในช่วงที่อนุญาตสําหรับประเภท int - หาก
xเป็นตัวเลขทศนิยมintจะแสดงผลค่าจำนวนเต็มของตัวเลขทศนิยม โดยปัดเศษให้ใกล้กับ 0 ระบบจะแสดงข้อผิดพลาดหาก x ไม่ใช่จำนวนจำกัด (NaN หรือ Infinity)
x เป็นประเภทอื่น หรือหากค่าเป็นสตริงที่ไม่ตรงกับรูปแบบข้างต้น ฟังก์ชันนี้ไม่อนุญาตให้ใช้อาร์กิวเมนต์เป็น 0 และไม่อนุญาตให้มีเว้นวรรคที่ไม่จำเป็นสำหรับอาร์กิวเมนต์สตริง ซึ่งแตกต่างจากฟังก์ชัน int ของ Pythonตัวอย่าง
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
|
ต้องระบุ ค่าที่จะรายงานความยาว |
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
|
iterable;
ค่าเริ่มต้นคือ []ออบเจ็กต์ที่จะแปลง |
สูงสุด
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
|
callable หรือ 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
|
callable หรือ 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)
start ถึง stop โดยใช้การเพิ่มขึ้น step หากระบุอาร์กิวเมนต์รายการเดียว รายการจะมีค่าตั้งแต่ 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;
ต้องระบุ ค่าขององค์ประกอบเริ่มต้นหากระบุค่าหยุดไว้ มิฉะนั้นค่าของหยุดและค่าเริ่มต้นจริงจะเป็น 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;
ต้องระบุ ลําดับที่วนซ้ำได้ (เช่น รายการ) ที่จะกลับรายการ |
ตั้งค่า
set set(elements=[])
--experimental_enable_starlark_set
สร้าง set ใหม่ โดยอาจเริ่มต้นให้ประกอบด้วยองค์ประกอบจากรายการที่วนซ้ำได้
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
elements
|
ค่าเริ่มต้นคือ []ชุด ลําดับ หรือพจนานุกรม |
จัดเรียง
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;
ต้องระบุ ลําดับที่วนซ้ำได้เพื่อจัดเรียง |
key
|
callable หรือ 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
|
iterable;
ค่าเริ่มต้นคือ ()ออบเจ็กต์ที่จะแปลง |
ประเภท
string type(x)
type(2) == "int" type([1]) == "list" type(struct(a = 2)) == "struct"
if type(x) == type([]): # if x is a list
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
x
|
required ออบเจ็กต์ที่จะตรวจสอบประเภท |
zip
list zip(*args)
list ของ tuple โดยที่แต่ละ tupple ของ 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 |