CogniTabDokumentasyon ng Script
/

Runtime v2.81 · Na-update noong Set 30, 2026

tuple

Collection

Isang iniutos na read-only na koleksyon.

Syntax

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

Mga parameter

Wala

Ibinabalik na halaga

tuple

Pagkilos / epekto

Isang iniutos na read-only na koleksyon. Gumamit ng mga literal na tuple kapag dapat manatiling maayos ang mga value pagkatapos ng paggawa o kapag nagbabalik ng mga nakagrupong value para sa pagsira.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga method

9 method

tuple.constructor

Creation Method

Create an empty tuple or clone another iterable as tuple.

Syntax

tuple()
tuple(iterable, /)

Mga parameter

PangalanPaglalarawan
iterableIterable
Optional iterable to clone into a tuple.
Depende sa paraan ng pagtawag · Ayon lang sa posisyon
Default: None

Ibinabalik na halaga

tuple — Isang bagong read-only na tuple.

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.literal

Creation Method

Gumawa ng tuple inline gamit ang mga panaklong at kuwit.

Syntax

(value1, value2, ...)

Mga parameter

PangalanPaglalarawan
valueAny?
Each item written inside tuple parentheses.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

tuple — Isang bagong tuple na nagpapanatili ng literal na kaayusan.

Pagkilos / epekto

Gumawa ng tuple inline gamit ang mga panaklong at kuwit.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.length

Method

Bilangin kung ilang bagay ang nasa tuple.

Syntax

len(tuple, /)

Mga parameter

PangalanPaglalarawan
tupletuple
The tuple to count.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Int — Bilang ng mga item ng tuple.

Pagkilos / epekto

Bilangin kung ilang bagay ang nasa tuple.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

offset = (0, 1)
count = len(offset)      # nagbabalik ng 2

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.index_access

Method

Basahin ang isang tuple item ayon sa index.

Syntax

tuple[index]

Mga parameter

PangalanPaglalarawan
tupletuple
Source tuple.
Kailangan · Ayon sa posisyon o pangalan
Walang default
indexInt
Item index. Use -1 for the last item.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Any? — tuple item sa index, o Wala kapag wala sa saklaw.

Pagkilos / epekto

Basahin ang isang tuple item ayon sa index. Ang mga negatibong index ay binibilang mula sa dulo.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.slice

Method

Kopyahin ang bahagi ng isang tuple gamit ang Python-style slicing.

Syntax

tuple[start:end[:step]]

Mga parameter

PangalanPaglalarawan
startInt
First item index to include.
Opsyonal · Ayon lang sa posisyon
Default: start of tuple
endInt
Stop before this item index.
Opsyonal · Ayon lang sa posisyon
Default: end of tuple
stepInt
Distance between items. Cannot be 0; negative values read backward.
Opsyonal · Ayon lang sa posisyon
Default: 1

Ibinabalik na halaga

tuple — Isang bagong tuple slice, na naka-clamp sa available na hanay.

Pagkilos / epekto

Kopyahin ang bahagi ng isang tuple gamit ang Python-style slicing. Ang mga inalis na hangganan ay gumagamit ng simula o wakas; ang mga negatibong index ay binibilang mula sa dulo.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.destructuring_assignment

Method

I-unpack ang mga item ng tuple sa tumutugmang target ng pagtatalaga.

Syntax

x, y = tuple

Mga parameter

PangalanPaglalarawan
x, yTargets
Assignment targets matching the tuple item count.
Kailangan · Ayon sa posisyon o pangalan
Walang default
tupletuple
Source tuple to unpack.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang mga target ay tumatanggap ng mga tuple item mula kaliwa hanggang kanan.

Pagkilos / epekto

I-unpack ang mga item ng tuple sa tumutugmang target ng pagtatalaga. Sinusuportahan ang mga nested target, ngunit hindi sinusuportahan ang mga naka-star na target gaya ng *rest.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.index_method

Method

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

Syntax

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

Mga parameter

PangalanPaglalarawan
valueAny?
Value that must exist in the tuple.
Kailangan · Ayon lang sa posisyon
Walang default
startInt
Start index for the search.
Opsyonal · Ayon lang sa posisyon
Default: 0
stopInt
Stop index for the search.
Opsyonal · Ayon lang sa posisyon
Default: len(tuple)

Ibinabalik na halaga

Int — First matching item index.

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.count_method

Method

Count matching tuple items.

Syntax

tuple.count(value, /)

Mga parameter

PangalanPaglalarawan
valueAny?
Value na bibilangin.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Int — Number of matches.

Pagkilos / epekto

Count matching tuple items.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

tuple.for_loop

Method

Ulitin ang mga item ng tuple mula kaliwa hanggang kanan.

Syntax

for item in tuple:

Mga parameter

PangalanPaglalarawan
itemAny
Current tuple item in loop.
Kailangan · Ayon sa posisyon o pangalan
Walang default
tupletuple
tuple to iterate.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga.

Pagkilos / epekto

Ulitin ang mga item ng tuple mula kaliwa hanggang kanan.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API