Added the force parameter to the assign method.

Author: nabeghe

composer.json

@@ -5,7 +5,7 @@
     "array", "array helper", "array utils", "array merge", "library", "helper", "support"
   ],
   "type": "library",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "homepage": "https://github.com/nabeghe/arrayer-php",
   "license": "MIT",
   "autoload": {

src/Traits/NabegheArrTrait.php

@@ -5,14 +5,16 @@
 trait NabegheArrTrait
 {
     /**
-     * Assigns a value to an array if the key doesn't exist.
+     * Assigns a value to a key in an array.
+     *
      * @param  array  $data
      * @param  mixed  $key
      * @param  mixed  $value
+     * @param  bool  $force Optional. If false, the new value will not be set if the key already exists. Drfault true.
      */
-    public static function assign(&$data, $key, $value)
+    public static function assign(&$data, $key, $value, $force = true)
     {
-        if (!array_key_exists($key, $data)) {
+        if ($force || !array_key_exists($key, $data)) {
             $data[$key] = $value;
         }
     }

tests/ArrTest.php

@@ -18,9 +18,9 @@ public function testAccessible()
     public function testAssign()
     {
         $data = ['key_1' => 'value_1', 'key_2' => null];
-        Arr::assign($data, 'key_1', 'new_value_1');
-        Arr::assign($data, 'key_2', 'new_value_2');
-        Arr::assign($data, 'key_3', 'new_value_3');
+        Arr::assign($data, 'key_1', 'new_value_1', false);
+        Arr::assign($data, 'key_2', 'new_value_2', false);
+        Arr::assign($data, 'key_3', 'new_value_3', false);
         $this->assertSame(['key_1' => 'value_1', 'key_2' => null, 'key_3' => 'new_value_3'], $data);
     }