add global function isTrue

Author: efureev

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog][keepachangelog] and this project adheres to [Semantic Versioning][semver].
 
+## v2.9.0
+
+### Added
+
+- Add global function: `isTrue`
+
 ## v2.8.0
 
 ### Added

readme.md

@@ -63,6 +63,7 @@ composer require efureev/support "^2.6"
 - Global functions
   + value
   + classNamespace
+  + isTrue
 - Exceptions
   + ConfigException
   + Exception

src/Global/base.php

@@ -31,3 +31,21 @@ function classNamespace($class): string
         return implode('\\', array_slice(explode("\\", $class), 0, -1));
     }
 }
+
+if (!function_exists('isTrue')) {
+    /**
+     * Returns bool value of a value
+     *
+     * @param mixed $val
+     * @param bool $return_null
+     *
+     * @return bool|null
+     */
+    function isTrue($val, bool $return_null = false): ?bool
+    {
+        $boolVal = (is_string($val)
+            ? filter_var($val, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE)
+            : (bool)$val);
+        return ($boolVal === null && !$return_null ? false : $boolVal);
+    }
+}

tests/Global/BaseTest.php

@@ -58,4 +58,41 @@ public function testValue(): void
             }
         }
     }
+
+    public function testIsTrue(): void
+    {
+        foreach (
+            [
+                ['val' => new \stdClass, 'res' => true,],
+                ['val' => [1, 2], 'res' => true,],
+                ['val' => [1], 'res' => true,],
+                ['val' => [0], 'res' => true,],
+                ['val' => 1, 'res' => true,],
+                ['val' => 42, 'res' => true,],
+                ['val' => -42, 'res' => true,],
+                ['val' => 'true', 'res' => true,],
+                ['val' => 'off', 'res' => false,],
+                ['val' => 'yes', 'res' => true,],
+                ['val' => 'no', 'res' => false,],
+                ['val' => 'ja', 'res' => false,],
+                ['val' => 'nein', 'res' => false,],
+                ['val' => 'нет', 'res' => false,],
+                ['val' => 'да', 'res' => false,],
+                ['val' => '1', 'res' => true,],
+                ['val' => null, 'res' => false,],
+                ['val' => 0, 'res' => false,],
+                ['val' => 'false', 'res' => false,],
+                ['val' => 'string', 'res' => false,],
+                ['val' => 'bool', 'res' => false,],
+                ['val' => '0.0', 'res' => false,],
+                ['val' => '4.2', 'res' => false,],
+                ['val' => '0', 'res' => false,],
+                ['val' => '', 'res' => false,],
+                ['val' => '[]', 'res' => false,],
+                ['val' => '{}', 'res' => false,],
+            ] as $data
+        ) {
+            $this->assertEquals(isTrue($data['val']), $data['res']);
+        }
+    }
 }