[PHP 8.6] Allow max to be null

Author: kylekatarnls

src/Php86/Php86.php

@@ -39,18 +39,20 @@ public static function clamp($value, $min, $max)
             self::throwValueErrorIfAvailable('clamp(): Argument #3 ($max) cannot be NAN');
         }
 
-        if ($max < $min) {
-            self::throwValueErrorIfAvailable('clamp(): Argument #2 ($min) must be smaller than or equal to argument #3 ($max)');
+        if ($max !== null) {
+            if ($max < $min) {
+                self::throwValueErrorIfAvailable('clamp(): Argument #2 ($min) must be smaller than or equal to argument #3 ($max)');
+            }
+
+            if ($value > $max) {
+                return $max;
+            }
         }
 
         if ($value < $min) {
             return $min;
         }
 
-        if ($value > $max) {
-            return $max;
-        }
-
         return $value;
     }
 

tests/Php86/Php86Test.php

@@ -33,6 +33,13 @@ public function testClamp(): void
         $this->assertSame('2025-08-20', clamp('2025-08-20', '2025-08-15', '2025-09-15'));
         $this->assertSame('2025-08-15', clamp(new \DateTimeImmutable('2025-08-01'), new \DateTimeImmutable('2025-08-15'), new \DateTimeImmutable('2025-09-15'))->format('Y-m-d'));
         $this->assertSame('2025-08-20', clamp(new \DateTimeImmutable('2025-08-20'), new \DateTimeImmutable('2025-08-15'), new \DateTimeImmutable('2025-09-15'))->format('Y-m-d'));
+        $this->assertSame(-1, clamp(null, -1, 1));
+        $this->assertSame(1, clamp(null, 1, 3));
+        $this->assertSame(-3, clamp(null, -3, -1));
+        $this->assertSame(-9999, clamp(-9999, null, 10));
+        $this->assertSame(10, clamp(12, null, 10));
+        $this->assertSame(5, clamp(-9999, 5, null));
+        $this->assertSame(12, clamp(12, 5, null));
 
         $errorMessage = null;