Merge pull request #11 from cocur/create-from-string

Add method to create Chain from string

src/Chain.php

@@ -85,4 +85,26 @@ public static function create(array $array = [])
 
         return $chain;
     }
+
+    /**
+     * @param string $delimiter If the option `regexp` is `true` this must be a regular expression
+     * @param string $string
+     * @param array  $options   If the option `regexp` is `true` the string is split by using `preg_split()`, otherwise
+     *                          `explode()` is used.
+     *
+     * @return Chain
+     */
+    public static function createFromString($delimiter, $string, array $options = [])
+    {
+        $options = array_merge(['regexp' => false], $options);
+        $chain   = new static();
+
+        if ($options['regexp']) {
+            $chain->array = preg_split($delimiter, $string);
+        } else {
+            $chain->array = explode($delimiter, $string);
+        }
+
+        return $chain;
+    }
 }

tests/ChainTest.php

@@ -22,6 +22,24 @@ public function createCreatesChain()
         $this->assertEquals([1, 2, 3], Chain::create([1, 2, 3])->array);
     }
 
+    /**
+     * @test
+     * @covers Cocur\Chain\Chain::createFromString()
+     */
+    public function createCreatesChainBySplittingStringWithDelimiter()
+    {
+        $this->assertEquals([1, 2, 3], Chain::createFromString(',', '1,2,3')->array);
+    }
+
+    /**
+     * @test
+     * @covers Cocur\Chain\Chain::createFromString()
+     */
+    public function createCreatesChainBySplittingStringWithRegExp()
+    {
+        $this->assertEquals([1, 2, 3, 4], Chain::createFromString('/[a-z]/', '1a2b3c4', ['regexp' => true])->array);
+    }
+
     /**
      * @test
      */