tuple (tupluri) în Python

Tuplul este o colecție ordonată care nu mai poate fi modificată după creare.

Sintaxă
tuplu = (element1, element2, ...)
tuple(iterabil)

Ce face tuple (tupluri)

Un tuplu seamănă cu o listă, dar este imutabil: după ce l-ai creat, nu poți adăuga, șterge sau schimba elemente. Se scrie cu paranteze rotunde, iar elementele se accesează la fel, prin index.

Tuplurile sunt potrivite pentru date care merg împreună și nu se schimbă: coordonate, o dată (an, lună, zi), o înregistrare. Pentru că sunt imutabile, pot fi folosite ca chei în dicționare.

Un tuplu cu un singur element are nevoie de virgulă: (5,). Fără virgulă, (5) este doar numărul 5 între paranteze.

Parametri

Parametru Descriere
iterabil Opțional, pentru tuple(). Colecția din care se construiește tuplul.

Ce returnează

tuple() returnează un tuplu nou.

Exemple

Exemplul 1: Creare și despachetare

punct = (3, 7)
x, y = punct
print(x, y)

data = (2026, 10, 19)
an, luna, zi = data
print(f"{zi}.{luna}.{an}")

Rezultat

3 7
19.10.2026

Exemplul 2: Tuplul nu poate fi modificat

culori = ("roșu", "galben", "albastru")
try:
    culori[0] = "verde"
except TypeError as eroare:
    print("Eroare:", eroare)

Rezultat

Eroare: 'tuple' object does not support item assignment

Exemplul 3: Tuplu cu un element și tuple()

print(type((5,)), type((5)))
print(tuple("abc"))
print(tuple([1, 2, 3]))
coordonate = {(45.75, 21.23): "Timișoara"}
print(coordonate[(45.75, 21.23)])

Rezultat

<class 'tuple'> <class 'int'>
('a', 'b', 'c')
(1, 2, 3)
Timișoara

Greșeli frecvente

  • Scrii (5) crezând că ai un tuplu cu un element. Pune virgula: (5,).
  • Încerci tuplu.append(...). Tuplurile nu au metode de modificare; transformă-l în listă cu list() dacă ai nevoie.

Comenzi înrudite

  • list (liste): Lista este o colecție ordonată și modificabilă de elemente, scrisă între paranteze drepte.
  • list.count() și tuple.count(): Numără de câte ori apare o valoare într-o listă sau într-un tuplu.
  • collections.namedtuple(): Creează un tip de tuplu cu câmpuri accesibile prin nume, nu doar prin poziție.
  • dict (dicționare): Dicționarul păstrează perechi cheie: valoare și găsește rapid valoarea după cheie.