Added Str::words() method

Author: PHLAK

README.md

@@ -156,6 +156,53 @@ $string->truncate(8); // Returns 'john...'
 
 ---
 
+### words
+> Split the string into an array of words.
+
+```php
+Twine\Str::words( void ) : array
+```
+
+#### Examples
+
+```php
+$string = new Twine\Str('john pinkerton');
+
+$string->words(); // Returns ['john', 'pinkerton']
+```
+
+```php
+$string = new Twine\Str('johnPinkerton');
+
+$string->words(); // Returns ['john', 'Pinkerton']
+```
+
+```php
+$string = new Twine\Str('JohnPinkerton');
+
+$string->words(); // Returns ['John', 'Pinkerton']
+```
+
+```php
+$string = new Twine\Str('john_pinkerton');
+
+$string->words(); // Returns ['john', 'pinkerton']
+```
+
+```php
+$string = new Twine\Str('john-pinkerton');
+
+$string->words(); // Returns ['john', 'pinkerton']
+```
+
+```php
+$string = new Twine\Str("john\npinkerton");
+
+$string->words(); // Returns ['john', 'pinkerton']
+```
+
+---
+
 ### append
 > Append one or more strings to the string.
 

src/Traits/Segmentable.php

@@ -57,4 +57,16 @@ public function truncate(int $length, string $suffix = '...') : self
             $this->first($length - strlen($suffix))->trimRight()->append($suffix)
         );
     }
+
+    /**
+     * Split the string into an array of words.
+     *
+     * @return array An array of words.
+     */
+    public function words() : array
+    {
+        preg_match_all('/[A-Z]?[a-z0-9]+/', $this->string, $matches);
+
+        return $matches[0];
+    }
 }

tests/SegmentableTest.php

@@ -101,4 +101,13 @@ public function test_a_multiline_string_is_truncated_to_one_line_when_truncated_
 
         $this->assertEquals('john pinkerton...', $truncated);
     }
+
+    public function test_it_can_be_split_into_an_array_of_words()
+    {
+        $string = new Twine\Str('john pinkerton-jingleHeimer_ShmidtJohnson');
+
+        $words = $string->words();
+
+        $this->assertEquals(['john', 'pinkerton', 'jingle', 'Heimer', 'Shmidt', 'Johnson'], $words);
+    }
 }