...
Eroare Swift · Erori fatale la rulare

Precondition failed: Cantitatea trebuie sa fie pozitiva

Pe scurt

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(...) și preconditionFailure(...) 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

Greșit
SWIFT
func adaugaInStoc(_ cantitate: Int) {
    precondition(cantitate > 0, "Cantitatea trebuie sa fie pozitiva")
    print("Adăugat \(cantitate)")
}
adaugaInStoc(0)
Corect
SWIFT
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

Greșit
SWIFT
let note = [7, 8]
assert(note.count >= 3, "Sunt necesare cel puțin 3 note")
Corect
SWIFT
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ă tu

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.

Codul care dă eroarea
SWIFT
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)")
După reparație, programul afișează
Stoc: 15
Ignorate: 1
Indiciu

În buclă, verifică if c > 0 înainte de apel; altfel crește un contor ignorate.

Alte forme ale mesajului

  • Assertion failed: Sunt necesare cel puțin 3 note
  • Fatal error: Neimplementat
  • Thread 1: Precondition failed

Cum o eviți pe viitor

  • Folosește precondition pentru 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

← Toate erorile Swift

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.