Precondition failed: Cantitatea trebuie sa fie pozitiva
O verificare precondition(conditie, "mesaj") din cod (al tău sau al unei biblioteci) a găsit condiția falsă și a oprit programul. Mesajul de după două puncte spune ce regulă a fost încălcată: repară datele trimise sau tratează cazul înainte de apel.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
precondition(conditie, mesaj) e o verificare pe care programatorul o pune intenționat: „dacă ajungem aici cu condiția falsă, e o greșeală de programare, oprește totul”. La rulare, Swift afișează fișierul, linia și mesajul: main.swift:3: Precondition failed: Cantitatea trebuie sa fie pozitiva.
Nu e un bug în Swift, ci o regulă a codului apelat: cineva a trimis date care nu respectă contractul funcției. Citește mesajul, apoi uită-te în stiva de apeluri la ce valori au ajuns în funcție.
Rude apropiate:
assert(conditie, mesaj)dăAssertion failed: ..., dar se verifică doar în build-urile Debug, nu și în Release;assertionFailure(...)șipreconditionFailure(...)opresc programul fără condiție;fatalError("mesaj")afișeazăFatal error: mesajși oprește programul în orice configurație.
Reparația corectă e aproape mereu la apelant: validezi datele înainte (de exemplu cu guard sau filter) sau tratezi cazul invalid.
De ce apare: cauzele frecvente
1Date care încalcă regula funcției
func adaugaInStoc(_ cantitate: Int) {
precondition(cantitate > 0, "Cantitatea trebuie sa fie pozitiva")
print("Adăugat \(cantitate)")
}
adaugaInStoc(0)func adaugaInStoc(_ cantitate: Int) {
precondition(cantitate > 0, "Cantitatea trebuie sa fie pozitiva")
print("Adăugat \(cantitate)")
}
let c = 0
if c > 0 { adaugaInStoc(c) } else { print("Cantitate invalidă") }Apelantul verifică datele înainte, iar funcția primește doar valori care respectă regula.
2assert în timpul dezvoltării
let note = [7, 8]
assert(note.count >= 3, "Sunt necesare cel puțin 3 note")let note = [7, 8]
if note.count < 3 {
print("Sunt necesare cel puțin 3 note")
}Pentru situații care pot apărea legitim (date introduse de utilizator) folosești o verificare normală, nu assert.
Repară eroarea, direct în pagină
Funcția adaugaInStoc cere o cantitate pozitivă. Programul procesează o listă de intrări în care una e invalidă (0) și trebuie să afișeze Stoc: 15 și Ignorate: 1, dar se oprește cu Precondition failed: Cantitatea trebuie sa fie pozitiva. Fără să modifici funcția, trimite-i doar cantitățile valide și numără-le pe cele ignorate.
var stoc = 0
func adaugaInStoc(_ cantitate: Int) {
precondition(cantitate > 0, "Cantitatea trebuie sa fie pozitiva")
stoc += cantitate
}
let intrari = [5, 0, 10]
var ignorate = 0
for c in intrari {
adaugaInStoc(c)
}
print("Stoc: \(stoc)")
print("Ignorate: \(ignorate)")Stoc: 15 Ignorate: 1
Indiciu
În buclă, verifică if c > 0 înainte de apel; altfel crește un contor ignorate.
Reparația
var stoc = 0
func adaugaInStoc(_ cantitate: Int) {
precondition(cantitate > 0, "Cantitatea trebuie sa fie pozitiva")
stoc += cantitate
}
let intrari = [5, 0, 10]
var ignorate = 0
for c in intrari {
if c > 0 {
adaugaInStoc(c)
} else {
ignorate += 1
}
}
print("Stoc: \(stoc)")
print("Ignorate: \(ignorate)")De ce merge
precondition e regula funcției: dacă primește 0, oprește programul. Problema era la apelant, care trimitea orice valoare. Acum bucla verifică întâi cantitatea: 5 și 10 ajung în stoc (total 15), iar 0 e doar numărat ca ignorat. Funcția rămâne protejată pentru orice alt apel greșit.
Alte forme ale mesajului
Assertion failed: Sunt necesare cel puțin 3 noteFatal error: NeimplementatThread 1: Precondition failed
Cum o eviți pe viitor
- Folosește
preconditionpentru reguli care, dacă sunt încălcate, înseamnă o greșeală de programare, nu pentru date introduse de utilizator. - Pentru date externe, întoarce o eroare (
throws) sau un opțional, ca apelantul să poată trata cazul. - Scrie mesaje clare în
precondition: ele sunt primul indiciu când programul se oprește.
Întrebări frecvente
Care e diferența dintre assert și precondition?
assert se verifică doar în Debug și dispare din build-ul Release. precondition se verifică și în Release (cu excepția optimizării -Ounchecked). Folosești precondition când continuarea cu date greșite ar fi periculoasă.
Pot prinde un precondition cu do-catch?
Nu. precondition, assert și fatalError nu sunt erori throws, ci opriri ale programului. Dacă vrei ca apelantul să poată reacționa, funcția trebuie să arunce o eroare.
Erori înrudite
Fatal error: 'try!' expression unexpectedly raised an error: main.EroareNota.invalida Ai folosit try!, care promite că apelul nu aruncă, iar funcția a aruncat totuși o eroare, așa că programul s-a oprit. Înlocuiește try! cu do-catch sau cu try? și tratează cazul de eroare. Fatal error: Index out of range Ai accesat un element de tablou cu un indice care nu există: negativ sau mai mare ori egal cu count (de exemplu lista[3] într-o listă cu 3 elemente). Indicii merg de la 0 la count - 1; verifică indicele sau folosește indices, first, last. error: call can throw but is not marked with 'try' Apelezi o funcție declarată throws fără try în față. Pune apelul într-un do { try ... } catch { ... }, folosește try? (dă nil la eroare) sau marchează și funcția ta cu throws ca să trimită eroarea mai departe. Învață Swift de la zero, cu exerciții la fiecare lecție
Curs Swift (iOS): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
