Guard-uri în match-case
În această lecție vei învăța cum adaugi o condiție după modelul unei ramuri case, astfel încât ramura să fie executată numai dacă modelul se potrivește și condiția suplimentară este adevărată.
Modelul poate să nu fie suficient
Uneori vrei să capturezi o valoare, dar ramura trebuie executată numai dacă valoarea respectă și o regulă.
punctaj = 95
match punctaj:
case valoare:
print(valoare) Modelul valoare capturează orice punctaj. El nu verifică însă dacă punctajul este suficient de mare.
Ce este un guard?
Un guard este o condiție scrisă după modelul unei ramuri case.
punctaj = 95
match punctaj:
case valoare if valoare >= 90:
print("Excelent")
case _:
print("Alt rezultat") Excelent
Sintaxa
match valoare:
case model if conditie:
instructiuni Ramura este aleasă numai dacă modelul se potrivește și condiția de după if este True.
Ordinea verificării
case valoare if valoare >= 90:
Mai întâi, valoarea analizată este capturată în variabila valoare. Apoi este evaluată condiția valoare >= 90.
Guard-ul este diferit de un if separat
match punctaj:
case valoare:
if valoare >= 90:
print("Excelent") Acest cod este valid, dar ramura case acceptă deja orice valoare. Un guard exprimă direct regula de selectare.
match punctaj:
case valoare if valoare >= 90:
print("Excelent") Mai multe praguri
punctaj = 75
match punctaj:
case valoare if valoare >= 90:
print("Excelent")
case valoare if valoare >= 60:
print("Promovat")
case _:
print("Respins") Promovat
Ordinea ramurilor contează
punctaj = 95
match punctaj:
case valoare if valoare >= 60:
print("Promovat")
case valoare if valoare >= 90:
print("Excelent") Promovat
Prima ramură compatibilă este executată. Ramura mai specifică trebuie scrisă înaintea celei mai generale.
Guard cu operatorul <
temperatura = -5
match temperatura:
case valoare if valoare < 0:
print("Îngheț")
case _:
print("Peste zero") Guard cu interval numeric
varsta = 25
match varsta:
case valoare if 18 <= valoare < 65:
print("Adult")
case _:
print("Altă categorie") Guard cu operatorul and
punctaj = 80
match punctaj:
case valoare if valoare >= 60 and valoare <= 100:
print("Punctaj valid și promovat")
case _:
print("Alt rezultat") Guard cu operatorul or
rol = "moderator"
match rol:
case valoare if valoare == "admin" or valoare == "moderator":
print("Acces extins")
case _:
print("Acces standard") Guard cu operatorul not
utilizator = "Ana"
blocati = ["Mihai", "Radu"]
match utilizator:
case nume if nume not in blocati:
print("Acces permis")
case _:
print("Acces blocat") Guard după un model literal
comanda = "sterge"
confirmat = True
match comanda:
case "sterge" if confirmat:
print("Ștergere executată")
case "sterge":
print("Confirmare necesară")
case _:
print("Altă comandă") Aceeași valoare literală în mai multe ramuri
Guard-urile permit ramuri diferite pentru aceeași valoare.
status = "activ"
este_admin = False
match status:
case "activ" if este_admin:
print("Administrator activ")
case "activ":
print("Utilizator activ")
case _:
print("Alt status") Guard după un model de listă
date = ["Ana", 95]
match date:
case [nume, punctaj] if punctaj >= 90:
print(nume, "are rezultat excelent")
case [nume, punctaj]:
print(nume, "are punctajul", punctaj) Guard după un model de tuplu
punct = (5, 8)
match punct:
case (x, y) if x == y:
print("Pe diagonală")
case (x, y):
print("Coordonate:", x, y) Guard după un model de dicționar
produs = {
"nume": "Laptop",
"stoc": 3
}
match produs:
case {"nume": nume, "stoc": stoc} if stoc > 0:
print(nume, "este disponibil")
case {"nume": nume}:
print(nume, "nu este disponibil") Variabilele capturate pot fi folosite în guard
date = [120, 2]
match date:
case [pret, cantitate] if pret * cantitate >= 200:
print("Comandă mare")
case _:
print("Comandă obișnuită") Variabilele pret și cantitate sunt disponibile în condiția guard-ului.
Guard-ul poate apela o funcție
def este_valid(email):
return "@" in email
email = "ana@example.com"
match email:
case valoare if este_valid(valoare):
print("Email valid")
case _:
print("Email invalid") Apelurile sunt executate numai după potrivirea modelului
def verifica(valoare):
print("Verific:", valoare)
return valoare > 0
date = [10, 20]
match date:
case [numar] if verifica(numar):
print("Un singur număr")
case _:
print("Altă structură") Primul model nu se potrivește, deoarece lista are două elemente. Funcția verifica() nu este apelată.
Un guard fals continuă cu următoarea ramură
valoare = 50
match valoare:
case numar if numar >= 90:
print("Excelent")
case numar if numar >= 60:
print("Promovat")
case _:
print("Respins") Respins
Modelul poate potrivi, dar guard-ul poate respinge
O ramură case este selectată numai dacă ambele verificări au succes.
model potrivit + guard True → ramură executată model potrivit + guard False → verifică ramura următoare model nepotrivit → verifică ramura următoare
Ramura implicită nu are nevoie de guard
match valoare:
case numar if numar > 0:
print("Pozitiv")
case _:
print("Zero sau negativ") Un guard pe case _ este posibil, dar rar util
match valoare:
case _ if conditie:
print("Condiție adevărată")
case _:
print("Condiție falsă") De obicei, un nume descriptiv capturat este mai clar decât _.
Guard și operatorul |
comanda = "start"
permisiune = True
match comanda:
case "start" | "restart" if permisiune:
print("Comandă executată")
case _:
print("Comandă refuzată") Condițiile complexe trebuie păstrate lizibile
match utilizator:
case date if (
date["activ"]
and date["varsta"] >= 18
and date["rol"] != "blocat"
):
print("Acces permis") Pentru condiții foarte complexe, o funcție separată poate fi mai ușor de citit și testat.
Guard versus model mai specific
Folosește un model pentru structură și valori literale. Folosește un guard pentru reguli care necesită comparații sau calcule.
case {"status": "activ", "varsta": varsta} if varsta >= 18: Exemplu din viața reală: reduceri
client = {
"tip": "premium",
"total": 1200
}
match client:
case {"tip": "premium", "total": total} if total >= 1000:
print("Reducere 20%")
case {"tip": "premium"}:
print("Reducere 10%")
case _:
print("Fără reducere") Exemplu din viața reală: autentificare
utilizator = {
"activ": True,
"rol": "admin"
}
match utilizator:
case {"activ": True, "rol": rol} if rol in ("admin", "editor"):
print("Acces permis")
case _:
print("Acces refuzat") Exemplu din viața reală: stoc
produs = ("Laptop", 2)
match produs:
case (nume, stoc) if stoc > 5:
print(nume, "- stoc suficient")
case (nume, stoc) if stoc > 0:
print(nume, "- stoc redus")
case (nume, _):
print(nume, "- indisponibil") Când sunt utile guard-urile?
Guard-urile sunt utile când modelul identifică structura sau capturează valorile, iar alegerea ramurii necesită și o regulă suplimentară.
Le poți folosi pentru praguri, intervale, permisiuni, stocuri, validări și reguli aplicate datelor despachetate.
Când este mai clar un if separat?
Dacă ramura case este deja foarte complexă sau dacă trebuie să efectuezi mai multe verificări succesive în aceeași ramură, un bloc if separat poate fi mai ușor de urmărit.
Greșeli frecvente
Scrii if înaintea modelului
Forma corectă este case model if conditie:.
Uiți două puncte
Ramura completă trebuie să se termine cu :.
Pui pragul general înaintea celui specific
Ramurile sunt verificate în ordine.
Crezi că guard-ul este verificat înaintea modelului
Condiția este evaluată numai după potrivirea modelului.
Rezumat
ModelStabilește forma sau valoarea care poate fi acceptată.
GuardAdaugă o condiție suplimentară după model.
OrdinePrima ramură cu model și guard valide este executată.
CapturareVariabilele modelului pot fi folosite în condiție.
Folosește exact o atribuire, un singur match, trei ramuri case, două guard-uri, două comparații >= și exact trei apeluri print() în source code. Nu folosi if în interiorul blocurilor case, elif, else, for, while, break, continue, operatorul…
Exercițiul, editorul și verificarea automată se deblochează cu Python OOP.

Alex Cristian
Iulian Pahom
Catalina Ioana Dan