Apply suggested changes and added language key and docs

Author: patel-vansh

system/DataCaster/Cast/FloatCast.php

@@ -38,23 +38,16 @@ public static function get(
             return (float) $value;
         }
 
-        // Map string flags to PHP constants
-        $modeMap = [
-            'up'   => PHP_ROUND_HALF_UP,
-            'down' => PHP_ROUND_HALF_DOWN,
-            'even' => PHP_ROUND_HALF_EVEN,
-            'odd'  => PHP_ROUND_HALF_ODD,
-        ];
-
         $mode = PHP_ROUND_HALF_UP; // Default mode
 
         if (isset($params[1])) {
-            $modeParam = strtolower($params[1]);
-            if (isset($modeMap[$modeParam])) {
-                $mode = $modeMap[$modeParam];
-            } else {
-                throw CastException::forInvalidFloatRoundingMode($params[1]);
-            }
+            $mode = match (strtolower($params[1])) {
+                'up'    => PHP_ROUND_HALF_UP,
+                'down'  => PHP_ROUND_HALF_DOWN,
+                'even'  => PHP_ROUND_HALF_EVEN,
+                'odd'   => PHP_ROUND_HALF_ODD,
+                default => throw CastException::forInvalidFloatRoundingMode($params[1]),
+            };
         }
 
         return round((float) $value, $precision, $mode);

system/Entity/Cast/FloatCast.php

@@ -13,10 +13,30 @@
 
 namespace CodeIgniter\Entity\Cast;
 
+use CodeIgniter\DataCaster\Exceptions\CastException;
+
 class FloatCast extends BaseCast
 {
     public static function get($value, array $params = []): float
     {
-        return (float) $value;
+        $precision = isset($params[0]) ? (int) $params[0] : null;
+
+        if ($precision === null) {
+            return (float) $value;
+        }
+
+        $mode = PHP_ROUND_HALF_UP; // Default mode
+
+        if (isset($params[1])) {
+            $mode = match (strtolower($params[1])) {
+                'up'    => PHP_ROUND_HALF_UP,
+                'down'  => PHP_ROUND_HALF_DOWN,
+                'even'  => PHP_ROUND_HALF_EVEN,
+                'odd'   => PHP_ROUND_HALF_ODD,
+                default => throw CastException::forInvalidFloatRoundingMode($params[1]),
+            };
+        }
+
+        return round((float) $value, $precision, $mode);
     }
 }

system/Language/en/Cast.php

@@ -13,18 +13,19 @@
 
 // Cast language settings
 return [
-    'baseCastMissing'        => 'The "{0}" class must inherit the "CodeIgniter\Entity\Cast\BaseCast" class.',
-    'enumInvalidCaseName'    => 'Invalid case name "{0}" for enum "{1}".',
-    'enumInvalidType'        => 'Expected enum of type "{1}", but received "{0}".',
-    'enumInvalidValue'       => 'Invalid value "{1}" for enum "{0}".',
-    'enumMissingClass'       => 'Enum class must be specified for enum casting.',
-    'enumNotEnum'            => 'The "{0}" is not a valid enum class.',
-    'invalidCastMethod'      => 'The "{0}" is invalid cast method, valid methods are: ["get", "set"].',
-    'invalidTimestamp'       => 'Type casting "timestamp" expects a correct timestamp.',
-    'jsonErrorCtrlChar'      => 'Unexpected control character found.',
-    'jsonErrorDepth'         => 'Maximum stack depth exceeded.',
-    'jsonErrorStateMismatch' => 'Underflow or the modes mismatch.',
-    'jsonErrorSyntax'        => 'Syntax error, malformed JSON.',
-    'jsonErrorUnknown'       => 'Unknown error.',
-    'jsonErrorUtf8'          => 'Malformed UTF-8 characters, possibly incorrectly encoded.',
+    'baseCastMissing'          => 'The "{0}" class must inherit the "CodeIgniter\Entity\Cast\BaseCast" class.',
+    'enumInvalidCaseName'      => 'Invalid case name "{0}" for enum "{1}".',
+    'enumInvalidType'          => 'Expected enum of type "{1}", but received "{0}".',
+    'enumInvalidValue'         => 'Invalid value "{1}" for enum "{0}".',
+    'enumMissingClass'         => 'Enum class must be specified for enum casting.',
+    'enumNotEnum'              => 'The "{0}" is not a valid enum class.',
+    'invalidCastMethod'        => 'The "{0}" is invalid cast method, valid methods are: ["get", "set"].',
+    'invalidTimestamp'         => 'Type casting "timestamp" expects a correct timestamp.',
+    'jsonErrorCtrlChar'        => 'Unexpected control character found.',
+    'jsonErrorDepth'           => 'Maximum stack depth exceeded.',
+    'jsonErrorStateMismatch'   => 'Underflow or the modes mismatch.',
+    'jsonErrorSyntax'          => 'Syntax error, malformed JSON.',
+    'jsonErrorUnknown'         => 'Unknown error.',
+    'jsonErrorUtf8'            => 'Malformed UTF-8 characters, possibly incorrectly encoded.',
+    'floatInvalidRoundingMode' => 'Invalid rounding mode "{0}" for float casting.',
 ];

user_guide_src/source/changelogs/v4.8.0.rst

@@ -245,6 +245,11 @@ Validation
 
 - Custom rule methods that set an error via the ``&$error`` reference parameter now support the ``{field}``, ``{param}``, and ``{value}`` placeholders, consistent with language-file and ``setRule()``/``setRules()`` error messages.
 
+Entities
+========
+
+- **Float and Double Casting:** Added support for precision and rounding mode when casting to float or double in entities.
+
 Others
 ======
 

user_guide_src/source/models/entities.rst

@@ -261,6 +261,7 @@ Add a question mark at the beginning of type to mark property as nullable, i.e.,
 
 .. note:: **int-bool** can be used since v4.3.0.
 .. note:: **enum** can be used since v4.7.0.
+.. note:: Since v4.8.0, you can also pass parameters to **float** and **double** types to specify the number of decimal places and rounding mode, i.e., **float[2,even]**.
 
 For example, if you had a User entity with an ``is_banned`` property, you can cast it as a boolean: