CogniTabTài liệu Script
/

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

tuple

Collection

Collection có thứ tự và chỉ đọc.

Cú pháp

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

Tham số

Không có

Giá trị trả về

tuple

Hành vi / tác động

Collection có thứ tự và chỉ đọc. Dùng tuple literal khi dữ liệu không cần thay đổi sau khi tạo hoặc khi gom giá trị để bung vào nhiều biế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ụ

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

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

9 phương thức

tuple.constructor

Creation Method

Tạo tuple rỗng hoặc sao chép iterable khác thành tuple.

Cú pháp

tuple()
tuple(iterable, /)

Tham số

TênMô tả
iterableIterable
Iterable tùy chọn để sao chép thành tuple.
Tùy dạng gọi · Chỉ truyền theo vị trí
Mặc định: None

Giá trị trả về

tuple — Một tuple chỉ đọc mới.

Hành vi / tác động

Tạo tuple rỗng hoặc sao chép iterable khác thành tuple. Dùng tuple literal cho nhiều giá trị viết trực tiếp.

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ụ

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

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

tuple.literal

Creation Method

Tạo tuple trực tiếp bằng ngoặc tròn và dấu phẩy.

Cú pháp

(value1, value2, ...)

Tham số

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

Giá trị trả về

tuple — tuple mới giữ nguyên thứ tự literal.

Hành vi / tác động

Tạo tuple trực tiếp bằng ngoặc tròn và dấu phẩy.

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ụ

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

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

tuple.length

Method

Đếm số phần tử trong tuple.

Cú pháp

len(tuple, /)

Tham số

TênMô tả
tupletuple
tuple 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ử trong tuple.

Hành vi / tác động

Đếm số phần tử trong tuple.

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ụ

offset = (0, 1)
count = len(offset)      # 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

tuple.index_access

Method

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

Cú pháp

tuple[index]

Tham số

TênMô tả
tupletuple
tuple 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ử tuple tại chỉ số, hoặc None nếu vượt phạm vi.

Hành vi / tác động

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

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ụ

pair = (10, 20)
x = pair[0]              # trả về 10
y = pair[-1]             # trả về 20

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

tuple.slice

Method

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

Cú pháp

tuple[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 tuple
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 tuple
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ề

tuple — Một tuple mới, đượ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 tuple bằng slicing kiểu Python. Bỏ trống biên sẽ dùng đầu hoặc cuối tuple; chỉ số âm đếm từ cuối tuple.

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 = (0, 1, 2, 3, 4)
middle = values[1:4]     # trả về (1, 2, 3)
reverse = values[::-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

tuple.destructuring_assignment

Method

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

Cú pháp

x, y = tuple

Tham số

TênMô tả
x, yTargets
Các target nhận giá trị, số lượng phải khớp số phần tử tuple.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
tupletuple
tuple 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ử tuple từ trái sang phải.

Hành vi / tác động

Bung các phần tử tuple 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ụ

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

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

tuple.index_method

Method

Tìm chỉ số phần tử khớp đầu tiên và báo lỗi rõ nếu không có.

Cú pháp

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

Tham số

TênMô tả
valueAny?
Giá trị bắt buộc phải có trong tuple.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
startInt
Chỉ số bắt đầu tìm.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: 0
stopInt
Chỉ số dừng tìm.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: len(tuple)

Giá trị trả về

Int — Chỉ số phần tử khớp đầu tiên.

Hành vi / tác động

Tìm chỉ số phần tử khớp đầu tiên và báo lỗi rõ nếu không có.

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ụ

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

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

tuple.count_method

Method

Đếm số phần tử tuple khớp giá trị.

Cú pháp

tuple.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ố lần khớp.

Hành vi / tác động

Đếm số phần tử tuple khớp giá trị.

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ụ

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

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

tuple.for_loop

Method

Lặp qua từng phần tử tuple từ trái sang phải.

Cú pháp

for item in tuple:

Tham số

TênMô tả
itemAny
Phần tử tuple 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
tupletuple
tuple 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.

Hành vi / tác động

Lặp qua từng phần tử tuple 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ụ

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

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