Added non-empty flag to toStringOrNull()

Signed-off-by: Tom Wright <tom@inflatablecookie.com>

CHANGELOG.md

@@ -1,3 +1,4 @@
+* Added non-empty flag to toStringOrNull()
 * Made PHP8.1 minimum version
 * Check for DateInterval parse failure
 

src/Coercion.php

@@ -35,14 +35,24 @@ public static function toString(
      * Coerce value to string or null
      */
     public static function toStringOrNull(
-        mixed $value
+        mixed $value,
+        bool $nonEmpty = false
     ): ?string {
         if (
             is_string($value) ||
             $value instanceof Stringable ||
             is_numeric($value)
         ) {
-            return (string)$value;
+            $output = (string)$value;
+
+            if (
+                $nonEmpty &&
+                $output === ''
+            ) {
+                return null;
+            }
+
+            return $output;
         }
 
         return null;