Runtime v2.81 · อัปเดต 30 ก.ย. 2569
คอลเลกชันแบบอ่านอย่างเดียวที่สั่งซื้อ ใช้ตัวอักษรทูเปิลเมื่อค่าควรคงที่หลังจากการสร้างหรือเมื่อส่งคืนค่าที่จัดกลุ่มเพื่อทำลายโครงสร้าง
รูปแบบคำสั่ง
tuple(iterable=(), /)
(value1, value2, ...)
พฤติกรรม / ผลข้างเคียง
คอลเลกชันแบบอ่านอย่างเดียวที่สั่งซื้อ ใช้ตัวอักษรทูเปิลเมื่อค่าควรคงที่หลังจากการสร้างหรือเมื่อส่งคืนค่าที่จัดกลุ่มเพื่อทำลายโครงสร้าง
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
offset = (0, 1)
x = offset[0]
y = offset[1]
if 1 in offset:
text("offset ready")
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
Create an empty tuple or clone another iterable as tuple.
รูปแบบคำสั่ง
tuple()
tuple(iterable, /)
ค่าที่ส่งกลับ
tuple — ทูเพิลแบบอ่านอย่างเดียวใหม่
พฤติกรรม / ผลข้างเคียง
Create an empty tuple or clone another iterable as tuple. Use a tuple literal for multiple inline values.
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
coords = (120, 340)
copy = tuple(coords)
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
สร้างทูเพิลแบบอินไลน์โดยใช้วงเล็บและเครื่องหมายจุลภาค
ค่าที่ส่งกลับ
tuple — tuple ใหม่รักษาลำดับตามตัวอักษร
พฤติกรรม / ผลข้างเคียง
สร้างทูเพิลแบบอินไลน์โดยใช้วงเล็บและเครื่องหมายจุลภาค
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
offset = (0, 1)
click(Point(500, 900), offset=offset)
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
นับจำนวนรายการในทูเพิล
ค่าที่ส่งกลับ
Int — จำนวนรายการทูเพิล
พฤติกรรม / ผลข้างเคียง
นับจำนวนรายการในทูเพิล
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
offset = (0, 1)
count = len(offset) # คืนค่า 2
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
อ่านหนึ่งรายการทูเพิลตามดัชนี ดัชนีเชิงลบนับจากจุดสิ้นสุด
ค่าที่ส่งกลับ
Any? — รายการทูเพิลที่ดัชนี หรือไม่มีเมื่ออยู่นอกช่วง
พฤติกรรม / ผลข้างเคียง
อ่านหนึ่งรายการทูเพิลตามดัชนี ดัชนีเชิงลบนับจากจุดสิ้นสุด
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
pair = (10, 20)
x = pair[0] # คืนค่า 10
y = pair[-1] # คืนค่า 20
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
คัดลอกส่วนหนึ่งของทูเพิลโดยใช้การแบ่งส่วนแบบ Python ขอบเขตที่ละไว้ใช้จุดเริ่มต้นหรือจุดสิ้นสุด ดัชนีติดลบนับจากจุดสิ้นสุด
ค่าที่ส่งกลับ
tuple — ชิ้นทูเพิลใหม่ ยึดเข้ากับช่วงที่มีอยู่
พฤติกรรม / ผลข้างเคียง
คัดลอกส่วนหนึ่งของทูเพิลโดยใช้การแบ่งส่วนแบบ Python ขอบเขตที่ละไว้ใช้จุดเริ่มต้นหรือจุดสิ้นสุด ดัชนีติดลบนับจากจุดสิ้นสุด
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
values = (0, 1, 2, 3, 4)
middle = values[1:4] # คืนค่า (1, 2, 3)
reverse = values[::-1] # คืนค่า (4, 3, 2, 1, 0)
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
tuple.destructuring_assignment
Method
แกะรายการทูเพิลออกเป็นเป้าหมายการมอบหมายที่ตรงกัน รองรับเป้าหมายที่ซ้อนกัน แต่ไม่รองรับเป้าหมายที่ติดดาว เช่น *rest
ค่าที่ส่งกลับ
None — ไม่มีค่าตอบแทนโดยตรง เป้าหมายได้รับไอเท็มทูเพิลจากซ้ายไปขวา
พฤติกรรม / ผลข้างเคียง
แกะรายการทูเพิลออกเป็นเป้าหมายการมอบหมายที่ตรงกัน รองรับเป้าหมายที่ซ้อนกัน แต่ไม่รองรับเป้าหมายที่ติดดาว เช่น *rest
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
label, (x, y) = ("target", (500, 900))
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
Find the first matching item index and fail visibly when absent.
รูปแบบคำสั่ง
tuple.index(value, start=0, stop=len(tuple), /)
ค่าที่ส่งกลับ
Int — First matching item index.
พฤติกรรม / ผลข้างเคียง
Find the first matching item index and fail visibly when absent.
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
pair = ("farm", "pvp")
index = pair.index("pvp")
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
Count matching tuple items.
ค่าที่ส่งกลับ
Int — Number of matches.
พฤติกรรม / ผลข้างเคียง
Count matching tuple items.
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
pair = ("farm", "farm", "pvp")
count = pair.count("farm")
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
วนซ้ำรายการทูเพิลจากซ้ายไปขวา
ค่าที่ส่งกลับ
None — ไม่มีค่าตอบแทนโดยตรง
พฤติกรรม / ผลข้างเคียง
วนซ้ำรายการทูเพิลจากซ้ายไปขวา
การทำงาน
- รอให้เสร็จ: ไม่
- ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
- การทำงานแบบขนาน: ใช่
การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์
ตัวอย่าง
offset = (0, 1)
for item in offset:
text(str(item))
ข้อผิดพลาด / ข้อจำกัด
ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น
