เมธอดที่ใช้ได้ในไฟล์ Bazel ทั้งหมด ซึ่งรวมถึงไฟล์ .bzl, BUILD, MODULE.bazel, VENDOR.bazel และ WORKSPACE
สมาชิก
- abs
- ทั้งหมด
- ใดก็ได้
- bool
- dict
- dir
- enumerate
- fail
- float
- getattr
- hasattr
- hash
- int
- len
- list
- สูงสุด
- นาที
- พิมพ์
- range
- repr
- ย้อนกลับ
- จัดเรียง
- str
- tuple
- ประเภท
- รหัสไปรษณีย์
ท้อง
unknown abs(x)แสดงผลค่าสัมบูรณ์ของตัวเลข (จำนวนที่ไม่เป็นลบซึ่งมีขนาดเท่ากัน)
abs(-2.3) == 2.3
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
int หรือ float
ต้องระบุ ตัวเลข (int หรือ float) |
ทั้งหมด
bool all(elements)แสดงผลเป็น "จริง" หากองค์ประกอบทั้งหมดประเมินเป็น "จริง" หรือหากคอลเล็กชันว่างเปล่า ระบบจะแปลงองค์ประกอบเป็นบูลีนโดยใช้ฟังก์ชัน bool
all(["hello", 3, True]) == True all([-1, 0, 1]) == False
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
elements
|
ต้องระบุ สตริงหรือคอลเล็กชันองค์ประกอบ |
ใดๆ
bool any(elements)แสดงค่า "จริง" หากองค์ประกอบอย่างน้อย 1 รายการประเมินเป็น "จริง" ระบบจะแปลงองค์ประกอบเป็นบูลีนโดยใช้ฟังก์ชัน bool
any([-1, 0, 1]) == True any([False, 0, ""]) == False
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
elements
|
ต้องระบุ สตริงหรือคอลเล็กชันขององค์ประกอบ |
บูลีน
bool bool(x=False)ตัวสร้างคอนสตรัคเตอร์สำหรับประเภทบูลีน โดยจะแสดงผล
False
หากออบเจ็กต์คือ None
, False
, สตริงว่าง (""
), หมายเลข 0
หรือคอลเล็กชันที่ว่างเปล่า (เช่น ()
, []
) ไม่เช่นนั้นจะแสดงผลเป็น True
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ค่าเริ่มต้นคือ False ตัวแปรที่จะแปลง |
ดิด
dict dict(pairs=[], **kwargs)สร้างพจนานุกรมจากอาร์กิวเมนต์ตำแหน่งที่ไม่บังคับและชุดอาร์กิวเมนต์คีย์เวิร์ดที่ไม่บังคับ ในกรณีที่มีการระบุคีย์เดียวกันหลายครั้ง ระบบจะใช้ค่าสุดท้าย ระบบจะถือว่ารายการที่ระบุผ่านอาร์กิวเมนต์คีย์เวิร์ดอยู่หลังรายการที่ระบุผ่านอาร์กิวเมนต์ตำแหน่ง
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
pairs
|
ค่าเริ่มต้นคือ [] คำสั่ง หรือคำสั่งที่ทำซ้ำซึ่งมีองค์ประกอบแต่ละองค์ประกอบมีความยาวเป็น 2 (คีย์, ค่า) |
kwargs
|
required คําจํากัดความของรายการเพิ่มเติม |
dir
list dir(x)แสดงผลรายการของสตริง ซึ่งหมายถึงชื่อของแอตทริบิวต์และเมธอดของออบเจ็กต์พารามิเตอร์
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบ |
แจกแจง
list enumerate(list, start=0)แสดงรายการคู่ (ข้อมูล 2 องค์ประกอบ) พร้อมดัชนี (int) และรายการจากลำดับอินพุต
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
list
|
ลำดับอินพุต ที่จำเป็น |
start
|
ค่าเริ่มต้นคือดัชนีเริ่มต้น 0 |
ล้มเหลว
None
fail(msg=None, attr=None, sep=" ", *args)
ทำให้การดำเนินการล้มเหลวโดยมีข้อผิดพลาด
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
msg
|
ค่าเริ่มต้นคือ None เลิกใช้งานแล้ว: ใช้อาร์กิวเมนต์ตำแหน่งแทน อาร์กิวเมนต์นี้ทำหน้าที่เหมือนอาร์กิวเมนต์ตำแหน่งนำโดยปริยาย |
attr
|
string หรือ None
ค่าเริ่มต้นคือ None เลิกใช้งานแล้ว ทําให้ระบบเพิ่มคำนำหน้า (ไม่บังคับ) ที่มีสตริงนี้ลงในข้อความแสดงข้อผิดพลาด |
sep
|
ค่าเริ่มต้นคือ " " สตริงตัวคั่นระหว่างออบเจ็กต์ ค่าเริ่มต้นคือช่องว่าง (" ") |
args
|
required ลิสต์ค่าที่มีการจัดรูปแบบด้วย debugPrint (ซึ่งเทียบเท่ากับ str โดยค่าเริ่มต้น) และต่อด้วย sep (ค่าเริ่มต้นคือ " ") ซึ่งปรากฏในข้อความแสดงข้อผิดพลาด |
จำนวนลอยตัว
float float(x=unbound)แสดง x เป็นค่าจำนวนลอยตัว
- หาก
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)แสดงผลช่อง Struct ของชื่อที่ระบุ หากมี หากไม่ตรง ระบบจะแสดง
default
(หากระบุ) หรือทำให้เกิดข้อผิดพลาด getattr(x, "foobar")
มีค่าเท่ากับ x.foobar
getattr(ctx.attr, "myattr") getattr(ctx.attr, "myattr", "mydefault")
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ต้องระบุ โครงสร้างที่มีการเข้าถึงแอตทริบิวต์ |
name
|
required ชื่อแอตทริบิวต์ struct |
default
|
default is unbound ค่าเริ่มต้นที่จะแสดงในกรณีที่โครงสร้างไม่มีแอตทริบิวต์ของชื่อที่ระบุ |
hasattr
bool hasattr(x, name)แสดงผลเป็น "จริง" หากออบเจ็กต์
x
มีแอตทริบิวต์หรือเมธอดของ name
ที่ระบุ หากไม่ใช่ "เท็จ" ตัวอย่างเช่นhasattr(ctx.attr, "myattr")
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบ |
name
|
required ชื่อแอตทริบิวต์ |
แฮช
int hash(value)แสดงผลค่าแฮชของสตริง ระบบจะคํานวณค่านี้อย่างแน่ชัดโดยใช้อัลกอริทึมเดียวกับ
String.hashCode()
ของ Java กล่าวคือ s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]ปัจจุบันระบบยังไม่รองรับการแฮชค่านอกเหนือจากสตริง
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
value
|
ต้องระบุ ค่าสตริงที่จะแฮช |
int
int int(x, base=unbound)แสดง x เป็นค่า int
- หาก
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
|
ค่าเริ่มต้นคือ [] ออบเจ็กต์ที่จะแปลง |
สูงสุด
unknown max(key=None, *args)แสดงผลอาร์กิวเมนต์ที่ใหญ่ที่สุดของอาร์กิวเมนต์ทั้งหมดที่ระบุ หากมีการระบุอาร์กิวเมนต์ตำแหน่งเพียงรายการเดียว อาร์กิวเมนต์ดังกล่าวต้องเป็นอาร์กิวเมนต์ที่ไม่ว่างเปล่า โดยเป็นข้อผิดพลาดหากองค์ประกอบไม่สามารถเปรียบเทียบได้ (เช่น int กับสตริง) หรือไม่ได้ระบุอาร์กิวเมนต์
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
|
ต้องระบุ องค์ประกอบที่จะตรวจสอบ |
นาที
unknown min(key=None, *args)แสดงผลค่าที่น้อยที่สุดของอาร์กิวเมนต์ทั้งหมดที่ระบุ หากระบุอาร์กิวเมนต์ตำแหน่งเพียง 1 รายการ อาร์กิวเมนต์ดังกล่าวต้องเป็นการซ้ำที่ไม่ว่างเปล่า ระบบจะแสดงข้อผิดพลาดหากองค์ประกอบไม่สามารถเปรียบเทียบกันได้ (เช่น int ที่มีสตริง) หรือหากไม่มีการให้อาร์กิวเมนต์
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
|
ต้องระบุ องค์ประกอบที่จะตรวจสอบ |
พิมพ์
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
|
required ค่าขององค์ประกอบเริ่มต้นหากระบุค่าหยุดไว้ มิฉะนั้นค่าของหยุดและค่าเริ่มต้นจริงจะเป็น 0 |
stop_or_none
|
int หรือ None
ค่าเริ่มต้นคือ None ตัวระบุรายการแรก (ไม่บังคับ) ที่ไม่รวมอยู่ในรายการผลลัพธ์ การสร้างรายการจะหยุดก่อนถึง stop
|
step
|
ค่าเริ่มต้นคือ 1 การเพิ่มขึ้น (ค่าเริ่มต้นคือ 1) ซึ่งอาจเป็นค่าลบ |
ตัวแทน
string repr(x)แปลงออบเจ็กต์เป็นค่าแทนสตริง ซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
repr("ab") == '"ab"'
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะแปลง |
ยกเลิก
list reversed(sequence)แสดงผลรายการใหม่แบบยกเลิกการตรึงซึ่งมีองค์ประกอบของลําดับที่วนซ้ำได้เดิมตามลําดับที่กลับกัน
reversed([3, 5, 4]) == [4, 5, 3]
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
sequence
|
ต้องระบุ ลําดับที่วนซ้ำได้ (เช่น รายการ) ที่จะกลับรายการ |
จัดเรียง
list sorted(iterable, key=None, *, reverse=False)แสดงรายการที่จัดเรียงใหม่ซึ่งมีองค์ประกอบทั้งหมดของลำดับที่ทำซ้ำได้ที่ระบุ ข้อผิดพลาดอาจเกิดขึ้นหากไม่สามารถเปรียบเทียบคู่องค์ประกอบ x, y โดยใช้ x < y ระบบจะจัดเรียงองค์ประกอบตามลำดับจากน้อยไปมาก เว้นแต่อาร์กิวเมนต์ย้อนกลับเป็น "จริง" ซึ่งในกรณีนี้ลำดับจากมากไปน้อย การจัดเรียงมีความเสถียร: องค์ประกอบที่เปรียบเทียบเท่ากันจะคงลำดับเดิมที่เกี่ยวข้องไว้
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
|
ต้องระบุ ลําดับที่วนซ้ำได้เพื่อจัดเรียง |
key
|
callable หรือ None
ค่าเริ่มต้นคือ None ฟังก์ชันที่ไม่บังคับซึ่งใช้กับแต่ละองค์ประกอบก่อนการเปรียบเทียบ |
reverse
|
ค่าเริ่มต้นคือ False แสดงผลลัพธ์ตามลําดับจากมากไปน้อย |
str
string str(x)แปลงออบเจ็กต์เป็นสตริง ซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
str("ab") == "ab" str(8) == "8"
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะแปลง |
มัด
tuple tuple(x=())แสดงผล Tuple ที่มีองค์ประกอบเดียวกันกับค่า "Iterable" ที่กำหนด
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"ฟังก์ชันนี้อาจมีการเปลี่ยนแปลงในอนาคต หากต้องการเขียนโค้ดที่เข้ากันได้กับ Python และใช้ได้ในอนาคต ให้ใช้เพื่อเปรียบเทียบผลลัพธ์เท่านั้น
if type(x) == type([]): # if x is a list
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
x
|
ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบประเภท |
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
|
รายการที่จำเป็น เพื่อบีบอัด |