tuple

Simpan item berurutan, termasuk duplikat, tanpa dapat menambah, menghapus, atau menggantinya setelah dibuat. List atau dictionary bersarang masih bisa berubah. Dalam kondisi, tuple kosong bernilai false dan tuple berisi bernilai true.

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

Buat tuple kosong atau salin item dari sumber yang dapat diulang ke dalam tuple. Koleksi bersarang tetap dibagi dengan sumber.

Sintaks

tuple()
tuple(iterable, /)

Parameter

NamaDeskripsi
iterableIterable
Sumber opsional yang dapat diulang, seperti string, list, atau generator.
Bergantung pada bentuk pemanggilan · Hanya posisi
Default: ()

Nilai yang dikembalikan

tuple — Tupel read-only baru.

Contoh

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

tuple.literal

Buat tuple dengan item yang dipisahkan koma. Gunakan (value,) untuk satu item; (value) saja bukan tuple.

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 posisi: 0 adalah yang pertama, -1 yang terakhir, dan indeks negatif lain dihitung dari akhir.

Sintaks

tuple[index]

Parameter

NamaDeskripsi
tupletuple
Source tuple.
Wajib · Posisi atau nama
Tanpa nilai bawaan
indexInt
Posisi item: 0 adalah yang pertama, -1 yang terakhir.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Any? — Item pada posisi tersebut. Memunculkan IndexError jika posisi di luar tuple.

Contoh

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

tuple.slice

Kembalikan tuple baru dari start hingga sebelum end. Indeks negatif dihitung dari akhir. Batas yang dikosongkan memilih seluruh tuple sesuai arah step; koleksi bersarang tetap dibagi.

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

Tetapkan item tuple ke variabel dari kiri ke kanan. Jumlah variabel harus sama dengan jumlah item, atau akan muncul error. Kelompok variabel dapat bersarang; *rest tidak didukung.

Sintaks

x, y = tuple

Parameter

NamaDeskripsi
x, yTargets
Variabel yang menerima item; jumlahnya harus sama dengan panjang tuple.
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

Kembalikan posisi kecocokan pertama dalam batas yang dipilih, atau munculkan ValueError jika nilainya tidak ada.

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
Posisi awal pencarian, dimulai dari 0. Nilai negatif dihitung dari akhir; batas di luar rentang disesuaikan ke rentang yang tersedia.
Opsional · Hanya posisi
Default: 0
stopInt
Hentikan pencarian sebelum posisi ini. Nilai negatif dihitung dari akhir; batas di luar rentang disesuaikan ke rentang yang tersedia.
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))