Merge pull request #42 from chrjean/master

add ifSetOr function

Author: aurimasniekis

README.md

@@ -32,6 +32,7 @@ Funct\firstValueNotEmpty($a, $b, $c)
         * [false](#falsevalue)
         * [firstValue](#firstvaluevaluea)
         * [firstValueNotEmpty](#firstvaluenotemptyvaluea-valueb)
+        * [ifSetOr](#ifSetOr)
         * [notEmpty](#notemptyvalue)
         * [notInArray](#notinarrayneedle-haystack-strict--null)
         * [notNull](#notnullvalue)
@@ -222,6 +223,15 @@ Funct\firstValueNotEmpty('', 'foo_bar'); // => 'foo_bar'
 Funct\firstValueNotEmpty('', null, 'foo_bar'); // => 'foo_bar'
 ```
 
+### ifSetOr($value, $default)
+Return the first param if isset or the second one or null if it doesn't
+
+```PHP
+$bar = 'bar';
+Funct\ifSetOr($foo); // => 'NULL'
+Funct\ifSetOr($foo, 'foo_bar'); // => 'foo_bar'
+Funct\ifSetOr($bar, 'foo_bar'); // => 'bar' ($bar value)
+```
 
 ### notEmpty($value)
 

src/General.php

@@ -153,3 +153,20 @@ function true($value)
 {
     return true === $value;
 }
+
+
+/**
+ * Returns the first param if isset or the second one or null if it doesn't
+ * 
+ * @param mixed $value
+ * @param mixed $default
+ * @return mixed
+ * @author Christophe Jean <cj@myjob.company>
+ */
+function ifSetOr(&$value, $default = null)
+{
+    if (isset($value)) {
+        return $value;
+    }
+    return $default;
+}

src/Tests/IfSetOrTest.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Funct\Tests;
+
+use Funct as Funct;
+
+/**
+ * Class IfSetOrTest
+ *
+ * @package Funct\Tests
+ * @author Christophe Jean <cj@myjob.company>
+*/
+class IfSetOrTest extends \PHPUnit_Framework_TestCase
+{
+    public function testIsNotSet()
+    {
+        $this->assertNull(Funct\ifSetOr($foo));
+        $this->assertEquals('bar', Funct\ifSetOr($foo2, 'bar'));
+    }
+    
+    public function testIsSet()
+    {
+        $foo = 'foo';
+        $this->assertEquals('foo', Funct\ifSetOr($foo));
+        $this->assertEquals('foo', Funct\ifSetOr($foo, 'x'));
+    }
+}