...
Eroare Kotlin · Tipuri și type mismatch

Value out of range

Pe scurt

Literalul numeric e prea mare chiar și pentru Long (peste 9.223.372.036.854.775.807). Pentru numere atât de mari folosește BigInteger sau BigDecimal, create dintr-un String: BigInteger("99999999999999999999").

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

Ce înseamnă

Un literal întreg din Kotlin devine Int dacă încape în Int, altfel Long. Peste Long.MAX_VALUE (9223372036854775807, 19 cifre) nu mai există tip primitiv, așa că compilatorul spune Value out of range și subliniază numărul.

Apare la coduri lungi tratate ca numere (IBAN, CNP-uri concatenate, coduri de bare lungi), la factoriale sau puteri scrise direct ca literal și la valori copiate din alte limbaje (Python are întregi nelimitați).

Reparații:

  • dacă e un identificator (cod, număr de card, telefon), păstrează-l ca String;
  • dacă chiar faci calcule cu el, folosește java.math.BigInteger("...") sau BigDecimal("...");
  • dacă îl calculezi, pornește de la BigInteger.ONE și înmulțește, nu scrie rezultatul ca literal.

De ce apare: cauzele frecvente

1Cod lung păstrat ca număr

Greșit
KOTLIN
val codBare = 59412345678901234567
Corect
KOTLIN
val codBare = "59412345678901234567"

Un cod nu e o cantitate: nu-l aduni și nu-l înmulțești, deci locul lui e într-un String.

2Număr mare folosit în calcule

Greșit
KOTLIN
val mare = 123456789012345678901
println(mare * 2)
Corect
KOTLIN
val mare = java.math.BigInteger("123456789012345678901")
println(mare * 2.toBigInteger())

BigInteger nu are limită de mărime; îl creezi dintr-un String ca să nu treci prin literalul prea mare.

3Constantă copiată din Python

Greșit
KOTLIN
val limita = 100000000000000000000
Corect
KOTLIN
val limita = java.math.BigInteger.TEN.pow(20)

În Python întregii sunt nelimitați; în Kotlin ai nevoie de BigInteger pentru 10^20.

Repară tu

Repară eroarea, direct în pagină

Programul vrea să dubleze un număr de 21 de cifre, scris direct ca literal, și compilarea se oprește cu Value out of range. Creează numărul ca BigInteger dintr-un String (importul există deja) ca programul să afișeze Dublu: 246913578024691357802.

Codul care dă eroarea
KOTLIN
import java.math.BigInteger

fun main() {
    val mare = 123456789012345678901
    println("Dublu: ${mare * 2}")
}
După reparație, programul afișează
Dublu: 246913578024691357802
Indiciu

Pune cifrele între ghilimele și dă-le constructorului BigInteger.

Alte forme ale mesajului

  • error: value out of range.
  • The value is out of range

Cum o eviți pe viitor

Pentru identificatori (CNP, IBAN, telefon, coduri de bare) folosește String, chiar dacă au doar cifre. Pentru sume de bani folosește BigDecimal, iar pentru calcule cu întregi foarte mari BigInteger. Reține limitele: Int până la aproximativ 2,1 miliarde, Long până la aproximativ 9,2 trilioane (19 cifre).

Întrebări frecvente

Dar 3000000000 de ce merge?

Pentru că încape în Long. Kotlin îl face automat Long dacă nu încape în Int. Doar peste limita lui Long primești Value out of range.

Pot folosi Double pentru numere foarte mari?

Poți, dar Double păstrează doar aproximativ 15-16 cifre semnificative, deci pierzi precizia. Pentru calcule exacte folosește BigInteger sau BigDecimal.

Erori înrudite

← Toate erorile Kotlin

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ță Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.