...
Eroare Swift · Erori fatale la rulare

Fatal error: Not enough bits to represent the passed value

Pe scurt

Convertești un număr într-un tip întreg prea mic pentru el, de exemplu Int8(300) sau UInt8(256), iar programul se oprește. Folosește un tip mai mare (Int), verifică intervalul înainte sau alege explicit Int8(clamping:) ori Int8(exactly:).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Tipurile întregi au intervale fixe: Int8 merge de la -128 la 127, UInt8 de la 0 la 255, Int16 de la -32768 la 32767, Int32 până la aproximativ 2,1 miliarde. Inițializatorul obișnuit Int8(x) presupune că valoarea încape. Dacă nu încape, Swift nu o taie în tăcere, ci oprește programul cu Fatal error: Not enough bits to represent the passed value.

Când valoarea e o constantă cunoscută la compilare, primești eroarea chiar de la compilator (integer literal '300' overflows when stored into 'Int8'). Varianta de la rulare apare când valoarea vine dintr-un calcul sau din date.

Ai trei variante, după ce vrei să se întâmple:

  • Int8(exactly: x) întoarce nil dacă nu încape;
  • Int8(clamping: x) se oprește la limită (300 devine 127);
  • Int8(truncatingIfNeeded: x) păstrează doar biții de jos (rar e ce vrei).

Pentru valori negative convertite la tipuri fără semn mesajul e Negative value is not representable.

De ce apare: cauzele frecvente

1Total prea mare pentru un tip mic

Greșit
SWIFT
let cutii = [90, 80, 70]
let total = Int8(cutii.reduce(0, +))
Corect
SWIFT
let cutii = [90, 80, 70]
let total = cutii.reduce(0, +)

240 nu încape în Int8 (max. 127). Pentru numărare și calcule obișnuite, Int e alegerea potrivită.

2Valoare care trebuie limitată

Greșit
SWIFT
let luminozitate = 300
let octet = UInt8(luminozitate)
Corect
SWIFT
let luminozitate = 300
let octet = UInt8(clamping: luminozitate)

clamping: duce valorile din afara intervalului la cea mai apropiată limită, 255.

3Negativ convertit la un tip fără semn

Greșit
SWIFT
let diferenta = 3 - 5
let n = UInt(diferenta)
Corect
SWIFT
let diferenta = 3 - 5
if let n = UInt(exactly: diferenta) { print(n) } else { print("negativ") }

UInt(exactly:) întoarce nil pentru valori care nu pot fi reprezentate, în loc să oprească programul.

Repară tu

Repară eroarea, direct în pagină

Programul adună cutiile livrate în trei zile și trebuie să afișeze Total cutii: 240, dar se oprește la rulare cu Fatal error: Not enough bits to represent the passed value. Repară conversia, astfel încât totalul să fie un Int obișnuit.

Codul care dă eroarea
SWIFT
let livrari = [90, 80, 70]
var suma = 0
for l in livrari {
    suma += l
}
let total = Int8(suma)
print("Total cutii: \(total)")
După reparație, programul afișează
Total cutii: 240
Indiciu

Int8 ține valori doar până la 127.

Alte forme ale mesajului

  • Fatal error: Negative value is not representable
  • Thread 1: Fatal error: Not enough bits to represent the passed value
  • error: integer literal '300' overflows when stored into 'Int8'

Cum o eviți pe viitor

  • Folosește Int pentru aproape toate valorile întregi; tipurile mici doar când un API sau un format de date le cere.
  • La conversii din date externe, folosește init(exactly:) și tratează nil.
  • Când limitarea la interval e comportamentul dorit, scrie-o explicit cu clamping:.

Întrebări frecvente

De ce Swift oprește programul în loc să taie valoarea, ca C?

Pentru că o valoare tăiată în tăcere produce rezultate greșite greu de găsit. Swift preferă să oprească imediat, iar dacă vrei tăierea, o ceri explicit cu truncatingIfNeeded:.

Apare și la Int?

Da, dacă convertești din Double sau din Int64 o valoare care nu încape. În editorul nostru din browser Int are 32 de biți, deci limita e 2.147.483.647; pe un Mac sau iPhone modern are 64 de biți.

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.