Move Long.toIntChecked() to extensions package

Author: rhaendel

src/main/kotlin/de/ronny_h/aoc/extensions/numbers/IntegralNumbers.kt

@@ -18,3 +18,10 @@ fun String.isInt(): Boolean = try {
 }
 
 fun sumOfFirstNaturalNumbers(n: Int): Long = (n * (n + 1).toLong()) / 2
+
+fun Long.toIntChecked(): Int {
+    if (this > Int.MAX_VALUE || this < Int.MIN_VALUE) {
+        throw IllegalArgumentException("$this exceeds Int range")
+    }
+    return this.toInt()
+}

src/main/kotlin/de/ronny_h/aoc/year2024/day17/ChronospatialComputer.kt

@@ -2,6 +2,7 @@ package de.ronny_h.aoc.year2024.day17
 
 import de.ronny_h.aoc.AdventOfCode
 import de.ronny_h.aoc.extensions.memoize
+import de.ronny_h.aoc.extensions.numbers.toIntChecked
 
 fun main() = ChronospatialComputer().run("4,1,7,6,4,1,0,2,7", "164279024971453")
 
@@ -263,10 +264,3 @@ class ThreeBitComputer(input: List<String>) {
         val instructionPointer: Int,
     )
 }
-
-private fun Long.toIntChecked(): Int {
-    if (this > Int.MAX_VALUE) {
-        throw IllegalArgumentException("$this exceeds Int range")
-    }
-    return this.toInt()
-}

src/test/kotlin/de/ronny_h/aoc/extensions/numbers/IntegralNumbersTest.kt

@@ -1,5 +1,6 @@
 package de.ronny_h.aoc.extensions.numbers
 
+import io.kotest.assertions.throwables.shouldThrow
 import io.kotest.core.spec.style.StringSpec
 import io.kotest.data.forAll
 import io.kotest.data.row
@@ -53,4 +54,26 @@ class IntegralNumbersTest : StringSpec({
             sumOfFirstNaturalNumbers(n) shouldBe sum
         }
     }
+
+    "Long values that are small enough can be converted to Int" {
+        forAll(
+            row(0L, 0),
+            row(42L, 42),
+            row(Int.MAX_VALUE.toLong(), Int.MAX_VALUE),
+            row(Int.MIN_VALUE.toLong(), Int.MIN_VALUE),
+        ) { longValue, intValue ->
+            longValue.toIntChecked() shouldBe intValue
+        }
+    }
+
+    "Long values that are too big cannot be converted to Int" {
+        forAll(
+            row(Int.MAX_VALUE.toLong() + 1),
+            row(Int.MIN_VALUE.toLong() - 1),
+        ) { longValue ->
+            shouldThrow<IllegalArgumentException> {
+                longValue.toIntChecked()
+            }
+        }
+    }
 })