[Input] Add hasValue()/resetValue() methods

This methods provide a flag for distinguish when $value contains a real `null` or the PHP default property value.

PHP gives to all properties a default value of `null` unless other default value is set.

Author: Maks3w

src/Input.php

@@ -67,6 +67,15 @@ class Input implements
      */
     protected $value;
 
+    /**
+     * Flag for distinguish when $value contains a real `null` or the PHP default property value.
+     *
+     * PHP gives to all properties a default value of `null` unless other default value is set.
+     *
+     * @var bool
+     */
+    protected $hasValue = false;
+
     /**
      * @var mixed
      */
@@ -163,12 +172,36 @@ public function setValidatorChain(ValidatorChain $validatorChain)
     }
 
     /**
+     * Set the input value.
+     *
+     * If you want to remove/unset the current value use {@link Input::resetValue()}.
+     *
+     * @see Input::getValue() For retrieve the input value.
+     * @see Input::hasValue() For to know if input value was set.
+     * @see Input::resetValue() For reset the input value to the default state.
+     *
      * @param  mixed $value
      * @return Input
      */
     public function setValue($value)
     {
         $this->value = $value;
+        $this->hasValue = true;
+        return $this;
+    }
+
+    /**
+     * Reset input value to the default state.
+     *
+     * @see Input::hasValue() For to know if input value was set.
+     * @see Input::setValue() For set a new value.
+     *
+     * @return Input
+     */
+    public function resetValue()
+    {
+        $this->value = null;
+        $this->hasValue = false;
         return $this;
     }
 
@@ -270,6 +303,23 @@ public function getValue()
         return $filter->filter($this->value);
     }
 
+    /**
+     * Flag for inform if input value was set.
+     *
+     * This flag used for distinguish when {@link Input::getValue()} will return a real `null` value or the PHP default
+     * value.
+     *
+     * @see Input::getValue() For retrieve the input value.
+     * @see Input::setValue() For set a new value.
+     * @see Input::resetValue() For reset the input value to the default state.
+     *
+     * @return bool
+     */
+    public function hasValue()
+    {
+        return $this->hasValue;
+    }
+
     /**
      * @return mixed
      */

test/InputTest.php

@@ -854,4 +854,36 @@ public function testWhenNotRequiredAndNotAllowEmptyAndContinueIfEmptyValidatorsA
         $input->setValue($value);
         $this->{$assertion}($input->isValid());
     }
+
+    /**
+     * @dataProvider emptyValuesProvider
+     *
+     * @param mixed $value
+     */
+    public function testSetValuePutInputInTheDesiredState($value)
+    {
+        $input = new Input();
+        $this->assertFalse($input->hasValue(), 'Input should not have value by default');
+
+        $input->setValue($value);
+        $this->assertTrue($input->hasValue(), "Input::hasValue() didn't return true when value was set");
+    }
+
+    /**
+     * @dataProvider emptyValuesProvider
+     *
+     * @param mixed $value
+     */
+    public function testResetValueReturnsInputValueToDefaultValue($value)
+    {
+        $input = new Input();
+        $this->assertFalse($input->hasValue(), 'Input should not have value by default');
+
+        $input->setValue($value);
+        $this->assertTrue($input->hasValue(), "Input::hasValue() didn't return true when value was set");
+
+        $return = $input->resetValue();
+        $this->assertSame($input, $return, 'Input::resetValue() must return itself');
+        $this->assertEquals(new Input(), $input, 'Input was not reset to the default value state');
+    }
 }