Runtime v2.81 · Cập nhật 30 thg 9, 2026

list

Danh sách có thứ tự.

Cú pháp

list(iterable=(), /)

Tham số

Không có

Giá trị trả về

list

Hành vi / tác động

Danh sách có thứ tự. Dùng khi bạn cần các giá trị có thể đếm, đọc theo vị trí, bung giá trị, hoặc lặp qua theo đúng thứ tự.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = list()
numbers.append(2)
numbers.extend([0, 3])
first = numbers[0]        # trả về 2
count = len(numbers)      # trả về 3

for value in numbers:
    wait(50)              # trả về None

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Không có

Phương thức

22 phương thức

list.constructor

Tạo list rỗng hoặc copy các phần tử từ một iterable vào list mới có thể cập nhật.

Cú pháp

list()
list(iterable, /)

Tham số

TênMô tả
iterableIterable
Nguồn giá trị cần copy vào list mới.
Tùy dạng gọi · Chỉ truyền theo vị trí
Mặc định: ()

Giá trị trả về

list — Một list mới có thể cập nhật.

Hành vi / tác động

Tạo list rỗng hoặc copy các phần tử từ một iterable vào list mới có thể cập nhật.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

copied = list(numbers)

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.literal

Tạo list literal ngay trong dòng.

Cú pháp

[1, 2, 3]

Tham số

TênMô tả
itemAny?
Mỗi phần tử được viết bên trong cặp ngoặc vuông.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

list — Một list mới có thể cập nhật và giữ nguyên thứ tự literal.

Hành vi / tác động

Tạo list literal ngay trong dòng. Đây là cách ngắn nhất khi bạn đã biết sẵn các phần tử.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [2, 0, 3]
first = numbers[0]       # trả về 2

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.comprehension

Tạo list bằng cách lặp qua iterable khác.

Cú pháp

[expr for target in iterable if condition]

Tham số

TênMô tả
exprAny?
Giá trị được thêm vào cho mỗi phần tử đạt điều kiện.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
targetName | destructuring target
Target nhận phần tử hiện tại. Chưa hỗ trợ starred target.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
iterableIterable
Nguồn giá trị cần lặp.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
conditionBoolean
Bộ lọc tùy chọn, được kiểm tra trước khi thêm phần tử.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: True

Giá trị trả về

list — Một list mới có thể cập nhật, giữ các phần tử phù hợp theo thứ tự lặp.

Hành vi / tác động

Tạo list bằng cách lặp qua iterable khác. Có thể dùng nhiều mệnh đề for/if, và biến vòng lặp chỉ tồn tại bên trong comprehension.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.range_source

Tạo một list số nguyên mới cho vòng lặp, bộ đếm, và dải số.

Cú pháp

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

Tham số

TênMô tả
startNumber
Giá trị bắt đầu (bao gồm).
Tùy dạng gọi · Chỉ truyền theo vị trí
Mặc định: 0
stopNumber
Giá trị kết thúc (không bao gồm).
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
stepNumber
Bước nhảy giữa các phần tử. Không được bằng 0.
Tùy dạng gọi · Chỉ truyền theo vị trí
Mặc định: 1

Giá trị trả về

list[Int] — Một list số nguyên mới.

Hành vi / tác động

Tạo một list số nguyên mới cho vòng lặp, bộ đếm, và dải số.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = range(5)         # trả về [0, 1, 2, 3, 4]
evens = range(0, 10, 2)   # trả về [0, 2, 4, 6, 8]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.length

Đếm xem list có bao nhiêu phần tử.

Cú pháp

len(list, /)

Tham số

TênMô tả
listlist
list cần đếm.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

Int — Số phần tử có trong list.

Hành vi / tác động

Đếm xem list có bao nhiêu phần tử.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = range(3, 8)     # trả về [3, 4, 5, 6, 7]
count = len(numbers)      # trả về 5

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.index_access

Đọc một phần tử theo chỉ số.

Cú pháp

list[index]

Tham số

TênMô tả
listlist
list nguồn.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
indexInt
Chỉ số phần tử. Dùng -1 để lấy phần tử cuối.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

Any? — Phần tử ở vị trí đó. Báo IndexError nếu chỉ số nằm ngoài list.

Hành vi / tác động

Đọc một phần tử theo chỉ số. Chỉ số âm sẽ đếm từ cuối list.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = range(10, 15)   # trả về [10, 11, 12, 13, 14]
first = numbers[0]        # trả về 10
third = numbers[2]        # trả về 12
last = numbers[-1]        # trả về 14

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.slice

Sao chép một phần list bằng slicing kiểu Python.

Cú pháp

list[start:end[:step]]

Tham số

TênMô tả
startInt
Chỉ số phần tử đầu tiên được lấy.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: start of list
endInt
Dừng trước chỉ số phần tử này.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: end of list
stepInt
Khoảng cách giữa các phần tử. Không được bằng 0; giá trị âm đọc ngược.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: 1

Giá trị trả về

list — Một list mới có thể cập nhật, được giới hạn trong phạm vi hiện có.

Hành vi / tác động

Sao chép một phần list bằng slicing kiểu Python. Bỏ trống biên sẽ dùng đầu hoặc cuối list; chỉ số âm đếm từ cuối list.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [0, 1, 2, 3, 4]
middle = numbers[1:4]     # trả về [1, 2, 3]
tail = numbers[-2:]       # trả về [3, 4]
reverse = numbers[::-1]   # trả về [4, 3, 2, 1, 0]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.index_assignment

Thay thế một phần tử đang có theo chỉ số.

Cú pháp

list[index] = value

Tham số

TênMô tả
listlist
list có thể cập nhật.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
indexInt
Chỉ số phần tử đang tồn tại. Dùng -1 để sửa phần tử cuối.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
valueAny?
Giá trị mới cần lưu ở vị trí đó.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. list được cập nhật ngay tại chỗ.

Hành vi / tác động

Thay thế một phần tử đang có theo chỉ số. Chỉ số âm sẽ đếm từ cuối list. Chỉ số phải nằm trong phạm vi list.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [12, 12, 21, 3, 2, 1]
numbers[4] = 3            # numbers trở thành [12, 12, 21, 3, 3, 1]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.destructuring_assignment

Bung các phần tử list vào số target tương ứng.

Cú pháp

a, b = list

Tham số

TênMô tả
a, bTargets
Các target nhận giá trị, số lượng phải khớp số phần tử list.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
listlist
list nguồn cần bung giá trị.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. Các target nhận phần tử list từ trái sang phải.

Hành vi / tác động

Bung các phần tử list vào số target tương ứng. Hỗ trợ target lồng nhau, nhưng chưa hỗ trợ starred target như *rest.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.append

Thêm một phần tử mới vào cuối list.

Cú pháp

list.append(value, /)

Tham số

TênMô tả
valueAny?
Giá trị cần thêm.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. list sẽ được cập nhật ngay tại chỗ.

Hành vi / tác động

Thêm một phần tử mới vào cuối list.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [2, 0]
numbers.append(3)
last = numbers[-1]        # trả về 3

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.extend

Nối từng phần tử từ iterable khác vào cuối list hiện tại.

Cú pháp

list.extend(iterable, /)

Tham số

TênMô tả
iterableIterable
Nguồn giá trị có các phần tử sẽ được nối thêm.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. list sẽ được nối dài ngay tại chỗ.

Hành vi / tác động

Nối từng phần tử từ iterable khác vào cuối list hiện tại.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1]
numbers.extend([2, 3])
count = len(numbers)      # trả về 3

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.insert

Chèn một phần tử vào trước chỉ số đã cho.

Cú pháp

list.insert(index, value, /)

Tham số

TênMô tả
indexInt
Vị trí mà giá trị sẽ được chèn vào trước đó.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
valueAny?
Giá trị cần chèn.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. list được cập nhật ngay tại chỗ.

Hành vi / tác động

Chèn một phần tử vào trước chỉ số đã cho. Chỉ số âm hoặc vượt phạm vi được giới hạn giống Python.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1, 3]
numbers.insert(1, 2)      # numbers trở thành [1, 2, 3]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.remove

Xóa phần tử đầu tiên có giá trị khớp với giá trị đã cho.

Cú pháp

list.remove(value, /)

Tham số

TênMô tả
valueAny?
Giá trị cần tìm và xóa khỏi list.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. Báo ValueError nếu không tìm thấy giá trị.

Hành vi / tác động

Xóa phần tử đầu tiên có giá trị khớp với giá trị đã cho.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1, 2, 2, 3]
numbers.remove(2)         # numbers trở thành [1, 2, 3]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.pop

Xóa một phần tử khỏi list rồi trả lại phần tử đó.

Cú pháp

list.pop(index=-1, /)

Tham số

TênMô tả
indexInt
Chỉ số tùy chọn cần xóa. Chỉ số âm đếm từ cuối list.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: -1

Giá trị trả về

Any? — Phần tử đã bị xóa. Báo IndexError nếu list rỗng hoặc chỉ số nằm ngoài list.

Hành vi / tác động

Xóa một phần tử khỏi list rồi trả lại phần tử đó. Nếu bỏ qua chỉ số thì xóa phần tử cuối.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [2, 0, 3]
removed = numbers.pop()   # trả về 3
first = numbers.pop(0)    # trả về 2

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.clear

Xóa toàn bộ phần tử trong list.

Cú pháp

list.clear()

Tham số

Không có

Giá trị trả về

None — Không trả về trực tiếp. list sẽ trở thành rỗng.

Hành vi / tác động

Xóa toàn bộ phần tử trong list.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [2, 0, 3]
numbers.clear()
text(str(len(numbers)))   # trả về 0

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.index

Trả về chỉ số đầu tiên có phần tử bằng value trong phạm vi start và stop tùy chọn.

Cú pháp

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

Tham số

TênMô tả
valueAny?
Giá trị cần tìm.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
startInt
Biên bắt đầu tùy chọn. Giá trị âm đếm từ cuối list.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: 0
stopInt
Biên kết thúc tùy chọn. Phần tử tại chỉ số này không được tính.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: len(list)

Giá trị trả về

Int — Chỉ số khớp. Báo ValueError nếu không tìm thấy giá trị.

Hành vi / tác động

Trả về chỉ số đầu tiên có phần tử bằng value trong phạm vi start và stop tùy chọn.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1, 2, 1, 3]
first_one = numbers.index(1)       # trả về 0
later_one = numbers.index(1, 1)    # trả về 2

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.count

Đếm số phần tử bằng giá trị đã cho.

Cú pháp

list.count(value, /)

Tham số

TênMô tả
valueAny?
Giá trị cần đếm.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

Int — Số phần tử khớp.

Hành vi / tác động

Đếm số phần tử bằng giá trị đã cho.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1, 2, 1, 3]
ones = numbers.count(1)   # trả về 2

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.sort

Sắp xếp list ngay tại chỗ bằng cùng quy tắc sắp xếp ổn định như sorted().

Cú pháp

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

Tham số

TênMô tả
keyCallable?
Hàm tùy chọn trả về khóa so sánh cho từng phần tử.
Tùy chọn · Chỉ truyền theo tên
Mặc định: None
reverseBoolean
Khi true, sắp xếp từ lớn đến nhỏ.
Tùy chọn · Chỉ truyền theo tên
Mặc định: False

Giá trị trả về

None — Không trả về trực tiếp. list được sắp xếp lại ngay tại chỗ.

Hành vi / tác động

Sắp xếp list ngay tại chỗ bằng cùng quy tắc sắp xếp ổn định như sorted().

Thực thi

  • Chờ hoàn tất: Tùy điều kiện
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Tùy điều kiện

Thao tác xử lý giá trị trong luồng gọi. Callable key cũng chạy tại đó và có thể chờ hoặc tạo tác dụng phụ; không có hàm ý thực thi bất đồng bộ.

Ví dụ

numbers = [3, 1, 2]
numbers.sort()
text(str(numbers))        # trả về [1, 2, 3]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.reverse

Đảo ngược list ngay tại chỗ.

Cú pháp

list.reverse()

Tham số

Không có

Giá trị trả về

None — Không trả về trực tiếp. Thứ tự list được đảo ngược ngay tại chỗ.

Hành vi / tác động

Đảo ngược list ngay tại chỗ.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1, 2, 3]
numbers.reverse()         # numbers trở thành [3, 2, 1]

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.copy

Tạo một bản copy nông của list và bản copy đó vẫn có thể cập nhật.

Cú pháp

list.copy()

Tham số

Không có

Giá trị trả về

list — Một list mới có thể cập nhật, giữ cùng tham chiếu phần tử.

Hành vi / tác động

Tạo một bản copy nông của list và bản copy đó vẫn có thể cập nhật.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = [1, 2]
copied = numbers.copy()
copied.append(3)
count = len(numbers)      # trả về 2

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.for_loop

Lặp qua từng phần tử theo thứ tự từ trái sang phải.

Cú pháp

for item in list:

Tham số

TênMô tả
itemAny
Phần tử hiện tại trong vòng lặp.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
listlist
list cần lặp.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. Vòng lặp sẽ chạy phần thân một lần cho mỗi phần tử.

Hành vi / tác động

Lặp qua từng phần tử theo thứ tự từ trái sang phải.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

steps = range(1, 4)      # trả về [1, 2, 3]
for step in steps:
    wait(step * 100)      # trả về None

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

list.truthy_check

Kiểm tra xem list có ít nhất một phần tử hay không.

Cú pháp

if list | if not list

Tham số

TênMô tả
listlist
list được dùng trong điều kiện.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean condition — true khi list không rỗng, false khi list rỗng.

Hành vi / tác động

Kiểm tra xem list có ít nhất một phần tử hay không. list rỗng sẽ được xem là false.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

numbers = range(0)        # trả về []
if not numbers:
    text("No items")      # trả về None

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan