CogniTabเอกสาร Script
/

Runtime v2.81 · อัปเดต 30 ก.ย. 2569

list

Collection

คอลเลกชันที่เรียงลำดับคุณสามารถสร้าง อ่าน วนซ้ำ ทำลายโครงสร้าง และอัปเดตในขณะที่สคริปต์ทำงาน

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

list(iterable=(), /)

พารามิเตอร์

ไม่มี

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

list

พฤติกรรม / ผลข้างเคียง

คอลเลกชันที่เรียงลำดับคุณสามารถสร้าง อ่าน วนซ้ำ ทำลายโครงสร้าง และอัปเดตในขณะที่สคริปต์ทำงาน

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

ไม่มี

เมธอด

22 เมธอด

list.constructor

Creation Method

สร้างรายการว่างหรือคัดลอกรายการจาก iterable หนึ่งรายการลงในรายการใหม่ที่แก้ไขได้

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

list()
list(iterable, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

สร้างรายการว่างหรือคัดลอกรายการจาก iterable หนึ่งรายการลงในรายการใหม่ที่แก้ไขได้

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

copied = list(numbers)

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.literal

Creation Method

สร้างรายการแบบอินไลน์ตามตัวอักษร นี่เป็นรูปแบบที่สั้นที่สุดเมื่อคุณรู้รายการแล้ว

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

[1, 2, 3]

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

สร้างรายการแบบอินไลน์ตามตัวอักษร นี่เป็นรูปแบบที่สั้นที่สุดเมื่อคุณรู้รายการแล้ว

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.comprehension

Creation Method

สร้างรายการโดยการวนซ้ำผ่านรายการอื่นที่ทำซ้ำได้ รองรับ for/if clause หลายรายการ และเป้าหมายแบบวนซ้ำจะยังคงอยู่ในระดับที่เข้าใจได้

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

[expr for target in iterable if condition]

พารามิเตอร์

ชื่อคำอธิบาย
exprAny?
Value to append for each accepted item.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
targetName | destructuring target
Loop target for the current item. Starred targets are not supported.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
iterableIterable
Source values to loop through.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
conditionBoolean
Optional filter checked before appending.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: True

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

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

พฤติกรรม / ผลข้างเคียง

สร้างรายการโดยการวนซ้ำผ่านรายการอื่นที่ทำซ้ำได้ รองรับ for/if clause หลายรายการ และเป้าหมายแบบวนซ้ำจะยังคงอยู่ในระดับที่เข้าใจได้

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.range_source

Creation Method

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

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

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

พารามิเตอร์

ชื่อคำอธิบาย
startNumber
Start value (inclusive).
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopNumber
End value (exclusive).
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
stepNumber
Increment between items. Cannot be 0.
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 1

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.length

Method

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

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

len(list, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.index_access

Method

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

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

list[index]

พารามิเตอร์

ชื่อคำอธิบาย
listlist
The source list.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
indexInt
Item index. Use -1 for the last item.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.slice

Method

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

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

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 — ส่วนรายการที่ไม่แน่นอนใหม่ ถูกบีบให้อยู่ในช่วงที่มีอยู่

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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]

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.index_assignment

Method

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

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

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]

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.destructuring_assignment

Method

แยกรายการออกเป็นเป้าหมายการมอบหมายที่ตรงกัน รองรับเป้าหมายที่ซ้อนกัน แต่ไม่รองรับเป้าหมายที่ติดดาว เช่น *rest

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

a, b = list

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

แยกรายการออกเป็นเป้าหมายการมอบหมายที่ตรงกัน รองรับเป้าหมายที่ซ้อนกัน แต่ไม่รองรับเป้าหมายที่ติดดาว เช่น *rest

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.append

Method

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

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

list.append(value, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.extend

Method

เพิ่มทุกรายการจาก iterable อื่นต่อท้ายรายการปัจจุบัน

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

list.extend(iterable, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

เพิ่มทุกรายการจาก iterable อื่นต่อท้ายรายการปัจจุบัน

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.insert

Method

แทรกรายการหนึ่งก่อนดัชนีที่กำหนด ดัชนีติดลบหรือเกินช่วงจะถูกจำกัดเหมือน Python

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

list.insert(index, value, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

แทรกรายการหนึ่งก่อนดัชนีที่กำหนด ดัชนีติดลบหรือเกินช่วงจะถูกจำกัดเหมือน Python

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.remove

Method

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

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

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]

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.pop

Method

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

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

list.pop(index=-1, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.clear

Method

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

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

list.clear()

พารามิเตอร์

ไม่มี

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.index

Method

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

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

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

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.count

Method

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

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

list.count(value, /)

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.sort

Method

เรียงลำดับ list ในที่เดิมโดยใช้กฎการเรียงแบบเสถียรเดียวกับ sorted()

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

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

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

เรียงลำดับ list ในที่เดิมโดยใช้กฎการเรียงแบบเสถียรเดียวกับ sorted()

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

การทำงานประมวลผลค่าในโฟลว์ผู้เรียก callable ของ key ก็ทำในนั้นและอาจรอหรือมีผลข้างเคียง ไม่ได้หมายถึงการทำงานแบบอะซิงโครนัส

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.reverse

Method

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

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

list.reverse()

พารามิเตอร์

ไม่มี

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.copy

Method

สร้างสำเนารายการที่ไม่แน่นอนแบบตื้น

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

list.copy()

พารามิเตอร์

ไม่มี

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

list — รายการที่ไม่แน่นอนใหม่ที่มีการอ้างอิงรายการเดียวกัน

พฤติกรรม / ผลข้างเคียง

สร้างสำเนารายการที่ไม่แน่นอนแบบตื้น

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.for_loop

Method

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

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

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

list.truthy_check

Method

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

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

if list | if not list

พารามิเตอร์

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

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

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

พฤติกรรม / ผลข้างเคียง

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

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

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

ตัวอย่าง

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

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง