tuple

Koleksi hanya-baca yang dipesan. Gunakan tuple literal ketika nilai harus tetap tetap setelah pembuatan atau ketika mengembalikan nilai yang dikelompokkan untuk destrukturisasi.

Sintaks

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

Nilai yang dikembalikan

Contoh

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

Metode

9 metode

tuple.constructor

Create an empty tuple or clone another iterable as tuple. Use a tuple literal for multiple inline values.

Sintaks

tuple()
tuple(iterable, /)

Parameter

NamaDeskripsi
iterableIterable
Optional iterable to clone into a tuple.
Bergantung pada bentuk pemanggilan · Hanya posisi
Default: None

Nilai yang dikembalikan

tuple — Tupel read-only baru.

Contoh

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

tuple.literal

Buat tuple inline menggunakan tanda kurung dan koma.

Sintaks

(value1, value2, ...)

Parameter

NamaDeskripsi
valueAny?
Each item written inside tuple parentheses.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

tuple — Tuple baru yang mempertahankan urutan literal.

Contoh

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

tuple.length

Hitung berapa banyak item yang ada di tuple.

Sintaks

len(tuple, /)

Parameter

NamaDeskripsi
tupletuple
The tuple to count.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Int — Jumlah item tupel.

Contoh

offset = (0, 1)
count = len(offset)      # mengembalikan 2

tuple.index_access

Baca satu item Tuple berdasarkan indeks. Indeks negatif dihitung dari akhir.

Sintaks

tuple[index]

Parameter

NamaDeskripsi
tupletuple
Source tuple.
Wajib · Posisi atau nama
Tanpa nilai bawaan
indexInt
Item index. Use -1 for the last item.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Any? — item tuple di indeks, atau Tidak Ada saat di luar jangkauan.

Contoh

pair = (10, 20)
x = pair[0]              # mengembalikan 10
y = pair[-1]             # mengembalikan 20

tuple.slice

Salin bagian tuple menggunakan pemotongan gaya Python. Batas yang dihilangkan menggunakan awal atau akhir; indeks negatif dihitung dari akhir.

Sintaks

tuple[start:end[:step]]

Parameter

NamaDeskripsi
startInt
First item index to include.
Opsional · Hanya posisi
Default: start of tuple
endInt
Stop before this item index.
Opsional · Hanya posisi
Default: end of tuple
stepInt
Distance between items. Cannot be 0; negative values read backward.
Opsional · Hanya posisi
Default: 1

Nilai yang dikembalikan

tuple — Potongan tupel baru, dijepit ke rentang yang tersedia.

Contoh

values = (0, 1, 2, 3, 4)
middle = values[1:4]     # mengembalikan (1, 2, 3)
reverse = values[::-1]   # mengembalikan (4, 3, 2, 1, 0)

tuple.destructuring_assignment

Buka paket tuple item ke dalam target penugasan yang cocok. Target bertumpuk didukung, namun target berbintang seperti *sisanya tidak didukung.

Sintaks

x, y = tuple

Parameter

NamaDeskripsi
x, yTargets
Assignment targets matching the tuple item count.
Wajib · Posisi atau nama
Tanpa nilai bawaan
tupletuple
Source tuple to unpack.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Target menerima tuple item dari kiri ke kanan.

Contoh

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

tuple.index_method

Find the first matching item index and fail visibly when absent.

Sintaks

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

Parameter

NamaDeskripsi
valueAny?
Value that must exist in the tuple.
Wajib · Hanya posisi
Tanpa nilai bawaan
startInt
Start index for the search.
Opsional · Hanya posisi
Default: 0
stopInt
Stop index for the search.
Opsional · Hanya posisi
Default: len(tuple)

Nilai yang dikembalikan

Int — First matching item index.

Contoh

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

tuple.count_method

Count matching tuple items.

Sintaks

tuple.count(value, /)

Parameter

NamaDeskripsi
valueAny?
Nilai yang akan dihitung.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Int — Number of matches.

Contoh

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

tuple.for_loop

Iterasi item Tuple dari kiri ke kanan.

Sintaks

for item in tuple:

Parameter

NamaDeskripsi
itemAny
Current tuple item in loop.
Wajib · Posisi atau nama
Tanpa nilai bawaan
tupletuple
tuple to iterate.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung.

Contoh

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