การลงทะเบียนและ CFP ของ BazelCon 2024 เปิดรับสมัครแล้ว
สำหรับเอกสารประกอบของรุ่นที่เสถียร โปรดใช้เมนูแบบเลื่อนลง "เอกสารที่มีเวอร์ชัน" มุมมองเริ่มต้นจะแสดงเวอร์ชันล่าสุดที่ HEAD

หน้านี้ได้รับการแปลโดย Cloud Translation API

ไฟล์ Bazel ทั้งหมด

รายงานปัญหา Nightly

เมธอดที่ใช้ได้ในไฟล์ Bazel ทั้งหมด รวมถึงไฟล์ .bzl, BUILD, MODULE.bazel, VENDOR.bazel และ WORKSPACE

สำหรับสมาชิก

abs
ทั้งหมด
ใดก็ได้
bool
dict
ไดเรกทอรี
แจกแจง
ล้มเหลว
float
getattr
hasattr
แฮช
int
len
list
สูงสุด
นาที
พิมพ์
ช่วง
ตอบกลับ
ย้อนกลับ
จัดเรียงแล้ว
str
tuple
ประเภท
zip

abs

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 bool(x=False)

ตัวสร้างสำหรับประเภทบูลีน โดยจะแสดงผล False หากออบเจ็กต์คือ None, False, สตริงว่าง (""), หมายเลข 0 หรือคอลเล็กชันที่ว่างเปล่า (เช่น (), []) ไม่เช่นนั้นจะแสดงผลเป็น True

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`x`	ค่าเริ่มต้นคือ `False` ตัวแปรที่จะแปลง

dict

dict dict(pairs=[], **kwargs)

สร้างพจนานุกรมจากอาร์กิวเมนต์ตำแหน่งที่ไม่บังคับและชุดอาร์กิวเมนต์คีย์เวิร์ดที่ไม่บังคับ ในกรณีที่มีการระบุคีย์เดียวกันหลายครั้ง ระบบจะใช้ค่าสุดท้าย ระบบจะถือว่ารายการที่ป้อนผ่านอาร์กิวเมนต์คีย์เวิร์ดจะอยู่หลังรายการที่ระบุผ่านอาร์กิวเมนต์ตำแหน่ง

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`pairs`	ค่าเริ่มต้นคือ `[]` คำสั่ง หรือคำสั่งที่ทำซ้ำซึ่งมีองค์ประกอบแต่ละองค์ประกอบมีความยาวเป็น 2 (คีย์, ค่า)
`kwargs`	ต้องระบุ พจนานุกรมของรายการเพิ่มเติม

ไดเรกทอรี

list dir(x)

แสดงผลรายการของสตริง ซึ่งหมายถึงชื่อของแอตทริบิวต์และเมธอดของออบเจ็กต์พารามิเตอร์

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`x`	ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบ

แจกแจง

list enumerate(list, start=0)

แสดงรายการคู่ (Tuple 2 องค์ประกอบ) พร้อมดัชนี (int) และรายการจากลำดับอินพุต

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`	string หรือ `None` ค่าเริ่มต้นคือ `None` เลิกใช้งานแล้ว ทำให้เพิ่มคำนำหน้าที่ไม่บังคับซึ่งมีสตริงนี้ลงในข้อความแสดงข้อผิดพลาด
`sep`	string; ค่าเริ่มต้นคือ `" "` สตริงตัวคั่นระหว่างออบเจ็กต์ ค่าเริ่มต้นคือช่องว่าง (" ")
`args`	ต้องระบุ รายการค่าที่จัดรูปแบบด้วย debugPrint (ซึ่งเทียบเท่ากับ str โดยค่าเริ่มต้น) และผนวกด้วย sep (ค่าเริ่มต้นเป็น " ") ซึ่งปรากฏในข้อความแสดงข้อผิดพลาด

float

float float(x=unbound)

แสดง x เป็นค่าจำนวนลอยตัว

หาก x เป็นแบบลอยอยู่แล้ว float จะแสดงผลเป็นค่าที่ไม่เปลี่ยนแปลง
หาก x เป็นบูลีน float จะแสดงผล 1.0 สำหรับ "จริง" และ 0.0 สำหรับ "เท็จ"
หาก 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`	ต้องระบุ Struct ที่มีการเข้าถึงแอตทริบิวต์
`name`	string; ต้องระบุ ชื่อของแอตทริบิวต์ Struct
`default`	ค่าเริ่มต้นคือ `unbound` ค่าเริ่มต้นที่จะแสดงผลในกรณีที่โครงสร้างไม่มีแอตทริบิวต์ของชื่อที่ระบุ

Hasattr

bool hasattr(x, name)

แสดงผลเป็น "จริง" หากออบเจ็กต์ x มีแอตทริบิวต์หรือเมธอดของ name ที่ระบุ หากไม่ใช่ "เท็จ" ตัวอย่างเช่น

hasattr(ctx.attr, "myattr")

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`x`	ต้องระบุ ออบเจ็กต์ที่จะตรวจสอบ
`name`	string; ต้องระบุ ชื่อของแอตทริบิวต์

แฮช

int hash(value)

แสดงผลค่าแฮชสำหรับสตริง ระบบคำนวณค่านี้โดยใช้อัลกอริทึมเดียวกับ String.hashCode() ของ Java ซึ่งได้แก่

s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]

ระบบไม่รองรับการแฮชค่านอกเหนือจากสตริงในขณะนี้

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`value`	string; required ค่าสตริงที่จะแฮช

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 ไม่ได้ ทั้งนี้เพื่อป้องกันความสับสนระหว่างเลขฐานแปดและทศนิยม ขนาดของจำนวนที่แสดงโดยสตริงจะต้องอยู่ภายในช่วงที่อนุญาตสำหรับประเภท int
หาก x เป็นเลขทศนิยม int จะแสดงผลค่าจำนวนเต็มของจำนวนลอยตัวโดยปัดเศษเข้าหา 0 หาก x ไม่ใช่ค่าจำกัด (ไม่มีหรือไม่มีสิ้นสุด) จะเกิดข้อผิดพลาด

ฟังก์ชันนี้จะดำเนินการไม่สำเร็จหาก 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 เป็นลิเทอรัลจำนวนเต็ม ต้องระบุพารามิเตอร์นี้หากค่าไม่ใช่สตริง

พารามิเตอร์	คำอธิบาย
`x`	ต้องระบุ สตริงที่จะแปลง
`base`	ค่าเริ่มต้นคือ `unbound` ฐานที่ใช้ในการแปลค่าสตริง ค่าเริ่มต้นคือ 10 ต้องอยู่ระหว่าง 2 ถึง 36 (รวม) หรือ 0 เพื่อตรวจหาฐานเสมือนว่า `x` เป็นลิเทอรัลจำนวนเต็ม ต้องระบุพารามิเตอร์นี้หากค่าไม่ใช่สตริง

len

int len(x)

แสดงผลความยาวของสตริง ลำดับ (เช่น รายการหรือ Tuple) dict หรืออื่นๆ ที่ทำซ้ำได้

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`x`	ต้องระบุ ค่าความยาวที่จะรายงาน

ลิสต์

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)

แสดงผลอาร์กิวเมนต์ที่น้อยที่สุดจากทั้งหมดที่ระบุ หากระบุอาร์กิวเมนต์ตำแหน่งเพียงรายการเดียว ค่านั้นต้องเป็นการซ้ำที่ไม่ว่างเปล่า โดยจะเกิดข้อผิดพลาดหากองค์ประกอบไม่สามารถเปรียบเทียบได้ (เช่น 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`	string; ค่าเริ่มต้นคือ `" "` สตริงตัวคั่นระหว่างออบเจ็กต์ ค่าเริ่มต้นคือช่องว่าง (" ")
`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) ซึ่งอาจเป็นค่าลบ

ตัวแทน

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`	bool; ค่าเริ่มต้นคือ `False` แสดงผลลัพธ์ในลำดับจากมากไปน้อย

str

string str(x)

แปลงออบเจ็กต์เป็นสตริง ซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง

str("ab") == "ab"
str(8) == "8"

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
`x`	ต้องระบุ ออบเจ็กต์ที่จะแปลง

tuple

tuple tuple(x=())

แสดงผล Tuple ที่มีองค์ประกอบเดียวกันกับค่า "ทำซ้ำ" ที่กำหนด

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 โดยที่ Tuple ตัว i มีองค์ประกอบ i-th จากลำดับอาร์กิวเมนต์หรืออาร์กิวเมนต์ที่ทำซ้ำได้แต่ละรายการ รายการมีขนาดของอินพุตที่สั้นที่สุด ด้วยอาร์กิวเมนต์ที่ซ้ำกันได้เพียงรายการเดียว จะแสดงผลรายการ 1-tuples หากไม่มีอาร์กิวเมนต์ ระบบจะแสดงรายการที่ว่างเปล่า ตัวอย่าง:

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`	รายการที่จำเป็น เพื่อบีบอัด