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
Creation Method
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ên
Mô 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.
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.
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.
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ên
Mô 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.
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.
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.
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.
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.
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.
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.
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ên
Mô 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.
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.
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ên
Mô 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.
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.
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.
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ên
Mô 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.
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.
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.
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.
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ên
Mô 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.
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ên
Mô 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.