CogniTabDokumentasi Script
/

Runtime v2.81 · Diperbarui 30 Sep 2026

tuple

Collection

Koleksi hanya-baca yang dipesan.

Sintaks

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

Parameter

Tidak ada

Nilai yang dikembalikan

tuple

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Tidak ada

Metode

9 metode

tuple.constructor

Creation Method

Create an empty tuple or clone another iterable as tuple.

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.literal

Creation Method

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.

Perilaku / efek samping

Buat tuple inline menggunakan tanda kurung dan koma.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.length

Method

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.

Perilaku / efek samping

Hitung berapa banyak item yang ada di tuple.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.index_access

Method

Baca satu item Tuple berdasarkan indeks.

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.slice

Method

Salin bagian tuple menggunakan pemotongan gaya Python.

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.destructuring_assignment

Method

Buka paket tuple item ke dalam target penugasan yang cocok.

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.index_method

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.count_method

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.

Perilaku / efek samping

Count matching tuple items.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

tuple.for_loop

Method

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.

Perilaku / efek samping

Iterasi item Tuple dari kiri ke kanan.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait