tuple

เก็บรายการตามลำดับและมีค่าซ้ำได้ แต่เพิ่ม ลบ หรือแทนที่หลังสร้างไม่ได้ list หรือ dictionary ที่ซ้อนอยู่ยังเปลี่ยนได้ ในเงื่อนไข tuple ว่างเป็น false และ tuple ที่มีรายการเป็น true

รูปแบบคำสั่ง

tuple(iterable=(), /)
(value1, value2, ...)

ค่าที่ส่งกลับ

ตัวอย่าง

offset = (0, 1)
x = offset[0]
y = offset[1]
if 1 in offset:
    text("offset ready")

เมธอด

9 เมธอด

tuple.constructor

สร้าง tuple ว่าง หรือคัดลอกรายการจากแหล่งข้อมูลที่วนลูปได้เป็น tuple คอลเลกชันที่ซ้อนอยู่ยังใช้ร่วมกับต้นทาง

รูปแบบคำสั่ง

tuple()
tuple(iterable, /)

พารามิเตอร์

ชื่อคำอธิบาย
iterableIterable
แหล่งข้อมูลเสริมที่วนลูปได้ เช่น สตริง list หรือ generator
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: ()

ค่าที่ส่งกลับ

tuple — ทูเพิลแบบอ่านอย่างเดียวใหม่

ตัวอย่าง

coords = (120, 340)
copy = tuple(coords)

tuple.literal

สร้าง tuple ด้วยรายการที่คั่นด้วยจุลภาค ใช้ (value,) สำหรับรายการเดียว ส่วน (value) เพียงอย่างเดียวไม่ใช่ tuple

รูปแบบคำสั่ง

(value1, value2, ...)

พารามิเตอร์

ชื่อคำอธิบาย
valueAny?
Each item written inside tuple parentheses.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

tuple — tuple ใหม่รักษาลำดับตามตัวอักษร

ตัวอย่าง

offset = (0, 1)
click(Point(500, 900), offset=offset)

tuple.length

นับจำนวนรายการในทูเพิล

รูปแบบคำสั่ง

len(tuple, /)

พารามิเตอร์

ชื่อคำอธิบาย
tupletuple
The tuple to count.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Int — จำนวนรายการทูเพิล

ตัวอย่าง

offset = (0, 1)
count = len(offset)      # คืนค่า 2

tuple.index_access

อ่านรายการ tuple ตามตำแหน่ง: 0 คือรายการแรก -1 คือรายการสุดท้าย และดัชนีติดลบอื่นนับจากท้าย

รูปแบบคำสั่ง

tuple[index]

พารามิเตอร์

ชื่อคำอธิบาย
tupletuple
Source tuple.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
indexInt
ตำแหน่งรายการ: 0 คือรายการแรก และ -1 คือรายการสุดท้าย
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Any? — รายการที่ตำแหน่งนั้น หากอยู่นอก tuple จะแจ้ง IndexError

ตัวอย่าง

pair = (10, 20)
x = pair[0]              # คืนค่า 10
y = pair[-1]             # คืนค่า 20

tuple.slice

คืน tuple ใหม่ตั้งแต่ start จนถึงก่อน end ดัชนีติดลบนับจากท้าย หากไม่ระบุขอบเขต จะเลือกทั้ง tuple ตามทิศทางของ step คอลเลกชันที่ซ้อนอยู่ยังใช้ร่วมกัน

รูปแบบคำสั่ง

tuple[start:end[:step]]

พารามิเตอร์

ชื่อคำอธิบาย
startInt
First item index to include.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: start of tuple
endInt
Stop before this item index.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: end of tuple
stepInt
Distance between items. Cannot be 0; negative values read backward.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 1

ค่าที่ส่งกลับ

tuple — ชิ้นทูเพิลใหม่ ยึดเข้ากับช่วงที่มีอยู่

ตัวอย่าง

values = (0, 1, 2, 3, 4)
middle = values[1:4]     # คืนค่า (1, 2, 3)
reverse = values[::-1]   # คืนค่า (4, 3, 2, 1, 0)

tuple.destructuring_assignment

กำหนดรายการใน tuple ให้ตัวแปรจากซ้ายไปขวา จำนวนตัวแปรต้องเท่ากับจำนวนรายการ มิฉะนั้นจะแจ้งข้อผิดพลาด กลุ่มตัวแปรซ้อนกันได้ แต่ไม่รองรับ *rest

รูปแบบคำสั่ง

x, y = tuple

พารามิเตอร์

ชื่อคำอธิบาย
x, yTargets
ตัวแปรที่รับรายการ จำนวนต้องเท่ากับความยาว tuple
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
tupletuple
Source tuple to unpack.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง เป้าหมายได้รับไอเท็มทูเพิลจากซ้ายไปขวา

ตัวอย่าง

label, (x, y) = ("target", (500, 900))

tuple.index_method

คืนตำแหน่งแรกที่ตรงกันในขอบเขตที่เลือก หรือแจ้ง ValueError หากไม่พบค่า

รูปแบบคำสั่ง

tuple.index(value, start=0, stop=len(tuple), /)

พารามิเตอร์

ชื่อคำอธิบาย
valueAny?
Value that must exist in the tuple.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt
ตำแหน่งแรกที่ค้นหา เริ่มที่ 0 ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt
หยุดค้นหาก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(tuple)

ค่าที่ส่งกลับ

Int — First matching item index.

ตัวอย่าง

pair = ("farm", "pvp")
index = pair.index("pvp")

tuple.count_method

Count matching tuple items.

รูปแบบคำสั่ง

tuple.count(value, /)

พารามิเตอร์

ชื่อคำอธิบาย
valueAny?
ค่าที่ต้องการนับ
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Int — Number of matches.

ตัวอย่าง

pair = ("farm", "farm", "pvp")
count = pair.count("farm")

tuple.for_loop

วนซ้ำรายการทูเพิลจากซ้ายไปขวา

รูปแบบคำสั่ง

for item in tuple:

พารามิเตอร์

ชื่อคำอธิบาย
itemAny
Current tuple item in loop.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
tupletuple
tuple to iterate.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง

ตัวอย่าง

offset = (0, 1)
for item in offset:
    text(str(item))