tuple

Lưu phần tử theo thứ tự, cho phép trùng nhau, nhưng không thể thêm, xóa hay thay thế sau khi tạo. List hay dictionary lồng bên trong vẫn có thể thay đổi. Trong điều kiện, tuple rỗng là false, tuple có phần tử là true.

Cú pháp

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

Giá trị trả về

Ví dụ

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

Phương thức

9 phương thức

tuple.constructor

Tạo tuple rỗng hoặc sao chép phần tử từ nguồn có thể lặp qua thành tuple. Collection lồng bên trong vẫn dùng chung với nguồn.

Cú pháp

tuple()
tuple(iterable, /)

Tham số

TênMô tả
iterableIterable
Nguồn tùy chọn có thể lặp qua, như chuỗi, list hay generator.
Tùy dạng gọi · Chỉ truyền theo vị trí
Mặc định: ()

Giá trị trả về

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

Ví dụ

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

tuple.literal

Tạo tuple với các phần tử cách nhau bằng dấu phẩy. Dùng (value,) cho một phần tử; chỉ viết (value) không tạo tuple.

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.

Ví dụ

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

tuple.length

Đế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.

Ví dụ

offset = (0, 1)
count = len(offset)      # trả về 2

tuple.index_access

Đọc phần tử tuple theo vị trí: 0 là đầu tiên, -1 là cuối cùng, các chỉ số âm khác đếm từ cuối.

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
Vị trí phần tử: 0 là đầu tiên, -1 là cuối cùng.
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ử tại vị trí đó. Báo IndexError nếu vị trí nằm ngoài tuple.

Ví dụ

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

tuple.slice

Trả về tuple mới từ start đến trước end. Chỉ số âm đếm từ cuối. Bỏ trống hai biên để lấy toàn bộ tuple theo chiều của step; collection lồng bên trong vẫn dùng chung.

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ó.

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)

tuple.destructuring_assignment

Gán phần tử tuple vào các biến từ trái sang phải. Số biến phải bằng số phần tử, nếu không sẽ báo lỗi. Có thể lồng nhóm biến; chưa hỗ trợ *rest.

Cú pháp

x, y = tuple

Tham số

TênMô tả
x, yTargets
Các biến nhận phần tử; số biến phải bằng độ dài 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.

Ví dụ

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

tuple.index_method

Trả về vị trí khớp đầu tiên trong phạm vi được chọn, hoặc báo ValueError nếu không có giá trị.

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
Vị trí bắt đầu tìm, tính từ 0. Số âm đếm từ cuối; biên vượt phạm vi được giới hạn trong phần hiện có.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: 0
stopInt
Dừng tìm trước vị trí này. Số âm đếm từ cuối; biên vượt phạm vi được giới hạn trong phần hiện có.
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.

Ví dụ

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

tuple.count_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.

Ví dụ

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

tuple.for_loop

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.

Ví dụ

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