list

เก็บรายการตามลำดับ โดยมีค่าซ้ำได้ อ่านตำแหน่งเริ่มที่ 0 วนลูปผ่านรายการ หรือเพิ่ม แทนที่ และลบรายการใน list เดิมได้

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

list(iterable=(), /)

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

ตัวอย่าง

numbers = list()
numbers.append(2)
numbers.extend([0, 3])
first = numbers[0]        # คืนค่า 2
count = len(numbers)      # คืนค่า 3

for value in numbers:
    wait(50)              # คืนค่า None

เมธอด

22 เมธอด

list.constructor

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

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

list()
list(iterable, /)

พารามิเตอร์

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

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

list — รายการที่ไม่แน่นอนใหม่

ตัวอย่าง

numbers = list()
numbers.append(2)
numbers.append(3)

copied = list(numbers)

list.literal

สร้าง list โดยเขียนรายการในวงเล็บเหลี่ยม

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

[1, 2, 3]

พารามิเตอร์

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

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

list — list ใหม่ที่มีรายการตามลำดับที่เขียน

ตัวอย่าง

numbers = [2, 0, 3]
first = numbers[0]       # คืนค่า 2

list.comprehension

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

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

[expr for target in iterable if condition]

พารามิเตอร์

ชื่อคำอธิบาย
exprAny?
Value to append for each accepted item.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
targetName | destructuring target
ตัวแปรหรือกลุ่มตัวแปรที่รับรายการปัจจุบัน ไม่รองรับตัวรับแบบ *rest
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
iterableIterable
แหล่งข้อมูลที่วนลูปได้ เช่น สตริง คอลเลกชัน หรือ generator หากเป็น dictionary จะได้คีย์
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
conditionBoolean
Optional filter checked before appending.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: True

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

list — รายการที่ไม่แน่นอนใหม่พร้อมรายการที่ตรงกันตามลำดับการวนซ้ำ

ตัวอย่าง

values = [1, 2, 3, 4]
evens = [x for x in values if x % 2 == 0]

list.range_source

สร้างรายการจำนวนเต็มใหม่สำหรับลูป ตัวนับ และช่วงตัวเลข

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

range(stop, /) | range(start, stop, step=1, /)

พารามิเตอร์

ชื่อคำอธิบาย
startNumber
Start value (inclusive).
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopNumber
End value (exclusive).
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
stepNumber
จำนวนที่เพิ่มเพื่อสร้างรายการถัดไป ค่าติดลบนับถอยหลัง ส่วน 0 ทำให้เกิดข้อผิดพลาด หากทิศทางของ step ห่างจาก stop จะได้ผลลัพธ์ว่าง
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 1

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

list[Int] — รายการจำนวนเต็มใหม่

ตัวอย่าง

numbers = range(5)         # คืนค่า [0, 1, 2, 3, 4]
evens = range(0, 10, 2)   # คืนค่า [0, 2, 4, 6, 8]

list.length

นับจำนวนรายการที่อยู่ในรายการ

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

len(list, /)

พารามิเตอร์

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

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

Int — จำนวนรายการในรายการ

ตัวอย่าง

numbers = range(3, 8)     # คืนค่า [3, 4, 5, 6, 7]
count = len(numbers)      # คืนค่า 5

list.index_access

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

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

list[index]

พารามิเตอร์

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

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

Any? — รายการที่ตำแหน่งนั้น เกิด IndexError เมื่อดัชนีอยู่นอกช่วงของรายการ

ตัวอย่าง

numbers = range(10, 15)   # คืนค่า [10, 11, 12, 13, 14]
first = numbers[0]        # คืนค่า 10
third = numbers[2]        # คืนค่า 12
last = numbers[-1]        # คืนค่า 14

list.slice

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

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

list[start:end[:step]]

พารามิเตอร์

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

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

list — ส่วนรายการที่ไม่แน่นอนใหม่ ถูกบีบให้อยู่ในช่วงที่มีอยู่

ตัวอย่าง

numbers = [0, 1, 2, 3, 4]
middle = numbers[1:4]     # คืนค่า [1, 2, 3]
tail = numbers[-2:]       # คืนค่า [3, 4]
reverse = numbers[::-1]   # คืนค่า [4, 3, 2, 1, 0]

list.index_assignment

แทนที่รายการที่มีอยู่หนึ่งรายการด้วยดัชนี ดัชนีเชิงลบนับจากจุดสิ้นสุด ดัชนีจะต้องอยู่ในรายการอยู่แล้ว

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

list[index] = value

พารามิเตอร์

ชื่อคำอธิบาย
listlist
The mutable list to update.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
indexInt
Item index that already exists. Use -1 for the last item.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
valueAny?
New value to store at that position.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

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

None — ไม่มีค่าตอบแทนโดยตรง รายการได้รับการอัปเดตในสถานที่

ตัวอย่าง

numbers = [12, 12, 21, 3, 2, 1]
numbers[4] = 3            # numbers กลายเป็น [12, 12, 21, 3, 3, 1]

list.destructuring_assignment

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

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

a, b = list

พารามิเตอร์

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

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

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

ตัวอย่าง

point = [500, 900]
x, y = point

list.append

เพิ่มหนึ่งรายการใหม่ต่อท้ายรายการ

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

list.append(value, /)

พารามิเตอร์

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

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

None — ไม่มีค่าตอบแทนโดยตรง รายการได้รับการอัปเดตในสถานที่

ตัวอย่าง

numbers = [2, 0]
numbers.append(3)
last = numbers[-1]        # คืนค่า 3

list.extend

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

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

list.extend(iterable, /)

พารามิเตอร์

ชื่อคำอธิบาย
iterableIterable
ค่าต้นทางที่รายการภายในจะถูกเพิ่มต่อท้าย
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

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

None — ไม่มีค่าตอบแทนโดยตรง รายการเติบโตขึ้น

ตัวอย่าง

numbers = [1]
numbers.extend([2, 3])
count = len(numbers)      # คืนค่า 3

list.insert

แทรกรายการก่อนตำแหน่งที่ระบุ ตำแหน่งเริ่มที่ 0 ดัชนีติดลบนับจากท้าย ดัชนีที่อยู่ก่อน list จะแทรกที่ต้น ส่วนดัชนีที่เกินท้ายจะแทรกที่ท้าย

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

list.insert(index, value, /)

พารามิเตอร์

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

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

None — ไม่มีค่าตอบแทนโดยตรง รายการได้รับการอัปเดตในสถานที่

ตัวอย่าง

numbers = [1, 3]
numbers.insert(1, 2)      # numbers กลายเป็น [1, 2, 3]

list.remove

ลบรายการแรกที่มีค่าตรงกับค่าที่กำหนด

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

list.remove(value, /)

พารามิเตอร์

ชื่อคำอธิบาย
valueAny?
Value to find and remove from the list.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

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

None — ไม่มีค่าตอบแทนโดยตรง เพิ่ม ValueError เมื่อไม่พบค่า

ตัวอย่าง

numbers = [1, 2, 2, 3]
numbers.remove(2)         # numbers กลายเป็น [1, 2, 3]

list.pop

ลบหนึ่งรายการออกจาก list แล้วส่งค่านั้นกลับมา หากไม่ระบุดัชนีจะลบรายการสุดท้าย

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

list.pop(index=-1, /)

พารามิเตอร์

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

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

Any? — รายการที่ถูกลบ เกิด IndexError เมื่อ list ว่างหรือดัชนีอยู่นอกช่วงของรายการ

ตัวอย่าง

numbers = [2, 0, 3]
removed = numbers.pop()   # คืนค่า 3
first = numbers.pop(0)    # คืนค่า 2

list.clear

ลบทุกรายการออกจากรายการ

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

list.clear()

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

None — ไม่มีค่าตอบแทนโดยตรง รายการจะว่างเปล่า

ตัวอย่าง

numbers = [2, 0, 3]
numbers.clear()
text(str(len(numbers)))   # คืนค่า 0

list.index

ส่งคืนดัชนีแรกที่รายการเท่ากับ value ภายในขอบเขต start และ stop ที่เลือกได้

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

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

พารามิเตอร์

ชื่อคำอธิบาย
valueAny?
ค่าที่ต้องการค้นหา
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt
ตำแหน่งแรกที่ค้นหา โดยรวมตำแหน่งนี้ด้วย ตำแหน่งเริ่มที่ 0 ค่าติดลบนับจากท้าย
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt
หยุดก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(list)

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

Int — ดัชนีที่ตรงกัน เกิด ValueError เมื่อไม่พบค่า

ตัวอย่าง

numbers = [1, 2, 1, 3]
first_one = numbers.index(1)       # คืนค่า 0
later_one = numbers.index(1, 1)    # คืนค่า 2

list.count

นับจำนวนรายการที่เท่ากับค่าที่กำหนด

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

list.count(value, /)

พารามิเตอร์

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

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

Int — จำนวนรายการที่ตรงกัน

ตัวอย่าง

numbers = [1, 2, 1, 3]
ones = numbers.count(1)   # คืนค่า 2

list.sort

เรียง list เดิมจากน้อยไปมาก ค่าที่เปรียบเทียบแล้วเท่ากันคงลำดับเดิม ค่าต้องเปรียบเทียบกันได้: ตัวเลขและบูลีน สตริง หรือ list/tuple ชนิดเดียวกันที่มีรายการเปรียบเทียบกันได้ หากผสมชนิดที่เข้ากันไม่ได้จะแจ้งข้อผิดพลาด

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

list.sort(*, key=None, reverse=False)

พารามิเตอร์

ชื่อคำอธิบาย
keyCallable?
ฟังก์ชันเสริมที่เรียกหนึ่งครั้งต่อรายการ เพื่อหาค่าที่ใช้เรียงลำดับ หากเป็น None จะเปรียบเทียบรายการเอง
ไม่บังคับ · ระบุชื่อเท่านั้น
ค่าเริ่มต้น: None
reverseBoolean
เมื่อเป็น true จะเรียงจากค่ามากไปน้อย
ไม่บังคับ · ระบุชื่อเท่านั้น
ค่าเริ่มต้น: False

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

None — ไม่มีค่าที่ส่งคืนโดยตรง list จะถูกเรียงลำดับใหม่ในที่เดิม

ตัวอย่าง

numbers = [3, 1, 2]
numbers.sort()
text(str(numbers))        # คืนค่า [1, 2, 3]

list.reverse

กลับลำดับ list ในที่เดิม

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

list.reverse()

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

None — ไม่มีค่าที่ส่งคืนโดยตรง ลำดับของ list จะถูกกลับในที่เดิม

ตัวอย่าง

numbers = [1, 2, 3]
numbers.reverse()         # numbers กลายเป็น [3, 2, 1]

list.copy

คืน list ใหม่ที่มีรายการเดิม การเพิ่ม ลบ หรือแทนที่รายการในสำเนาไม่เปลี่ยนต้นฉบับ แต่คอลเลกชันที่ซ้อนอยู่ยังใช้ร่วมกัน

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

list.copy()

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

list — list ใหม่ โดยไม่คัดลอกคอลเลกชันที่ซ้อนอยู่

ตัวอย่าง

numbers = [1, 2]
copied = numbers.copy()
copied.append(3)
count = len(numbers)      # คืนค่า 2

list.for_loop

วนซ้ำรายการต่างๆ ตามลำดับจากซ้ายไปขวา

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

for item in list:

พารามิเตอร์

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

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

None — ไม่มีค่าตอบแทนโดยตรง ลูปจะรันเนื้อหาหนึ่งครั้งต่อรายการ

ตัวอย่าง

steps = range(1, 4)      # คืนค่า [1, 2, 3]
for step in steps:
    wait(step * 100)      # คืนค่า None

list.truthy_check

ตรวจสอบว่ารายการมีอย่างน้อยหนึ่งรายการหรือไม่ รายการว่างจะถือเป็นเท็จ

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

if list | if not list

พารามิเตอร์

ชื่อคำอธิบาย
listlist
The list used in the condition.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

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

Boolean condition — จริงเมื่อรายการไม่ว่างเปล่า เท็จเมื่อรายการว่างเปล่า

ตัวอย่าง

numbers = range(0)        # คืนค่า []
if not numbers:
    text("No items")      # คืนค่า None