3.0.0

Merge pull request #160 from danielstjules/3.x-dev
3.x
2025-09-02 01:22:37 +02:00 · 2017-03-08 19:52:40 -05:00 · 2017-03-08 19:44:04 -05:00 · 2017-03-08 19:23:05 -05:00 · 2017-03-08 19:16:09 -05:00 · 2017-03-06 15:11:14 -05:00
8 changed files with 1351 additions and 1266 deletions
--- a/.travis.yml
+++ b/.travis.yml
@@ -10,10 +10,6 @@ sudo: false
 matrix:
  fast_finish: true
  include:
-    - php: 5.3
-      env: polyfill='true'
-    - php: 5.3
-      env: polyfill='false'
    - php: 5.4
      env: polyfill='true'
    - php: 5.4
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,11 @@
+### 3.0.0 (2017-03-08)
+
+* Breaking change: added $language parameter to toAscii, before
+  $removeUnsupported
+* Breaking change: dropped PHP 5.3 support
+* Breaking change: any StaticStringy methods that previously returned instances
+  of Stringy now return strings
+
 ### 2.4.0 (2017-03-02)

 * Add startsWithAny
--- a/README.md
+++ b/README.md
@@ -1,13 +1,16 @@
 ![Stringy](http://danielstjules.com/github/stringy-logo.png)

 A PHP string manipulation library with multibyte support. Compatible with PHP
-5.3+, PHP 7, and HHVM. Refer to the [1.x branch](https://github.com/danielstjules/Stringy/tree/1.x)
-for older documentation.
+5.4+, PHP 7, and HHVM.

 ``` php
 s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
 ```

+Refer to the [1.x branch](https://github.com/danielstjules/Stringy/tree/1.x) or
+[2.x branch](https://github.com/danielstjules/Stringy/tree/2.x) for older
+documentation.
+
 [![Build Status](https://api.travis-ci.org/danielstjules/Stringy.svg?branch=master)](https://travis-ci.org/danielstjules/Stringy)
 [![Total Downloads](https://poser.pugx.org/danielstjules/stringy/downloads)](https://packagist.org/packages/danielstjules/stringy)
 [![License](https://poser.pugx.org/danielstjules/stringy/license)](https://packagist.org/packages/danielstjules/stringy)
@@ -42,7 +45,7 @@ s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
    </tr>
    <tr>
        <td>[endsWith](#endswithstring-substring--boolean-casesensitive--true-)</td>
-        <td>[endsWithAny](#endsWithAnystring-substrings--boolean-casesensitive--true-)</td>
+        <td>[endsWithAny](#endswithanystring-substrings--boolean-casesensitive--true-)</td>
        <td>[ensureLeft](#ensureleftstring-substring)</td>
        <td>[ensureRight](#ensurerightstring-substring)</td>
    </tr>
@@ -74,7 +77,7 @@ s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
        <td>[isLowerCase](#islowercase)</td>
        <td>[isSerialized](#isserialized)</td>
        <td>[isUpperCase](#isuppercase)</td>
-        <td>[last](#last)</td>
+        <td>[last](#lastint-n)</td>
    </tr>
    <tr>
        <td>[length](#length)</td>
@@ -97,7 +100,7 @@ s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
    <tr>
        <td>[removeLeft](#removeleftstring-substring)</td>
        <td>[removeRight](#removerightstring-substring)</td>
-        <td>[repeat](#repeatmultiplier)</td>
+        <td>[repeat](#repeatint-multiplier)</td>
        <td>[replace](#replacestring-search-string-replacement)</td>
    </tr>
    <tr>
@@ -107,10 +110,10 @@ s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
        <td>[slugify](#slugify-string-replacement----)</td>
    </tr>
    <tr>
-        <td>[startsWith](#startswithstring-substring--boolean-casesensitive--true-)</td>
-        <td>[startsWithAny](#startswithanystring-substrings--boolean-casesensitive--true-)</td>
        <td>[slice](#sliceint-start--int-end-)</td>
        <td>[split](#splitstring-pattern--int-limit-)</td>
+        <td>[startsWith](#startswithstring-substring--boolean-casesensitive--true-)</td>
+        <td>[startsWithAny](#startswithanystring-substrings--boolean-casesensitive--true-)</td>
    </tr>
    <tr>
        <td>[stripWhitespace](#stripwhitespace)</td>
@@ -121,7 +124,7 @@ s('string')->toTitleCase()->ensureRight('y') == 'Stringy'
    <tr>
        <td>[tidy](#tidy)</td>
        <td>[titleize](#titleize-array-ignore)</td>
-        <td>[toAscii](#toascii)</td>
+        <td>[toAscii](#toascii-string-locale--en--bool-removeunsupported--true-)</td>
        <td>[toBoolean](#toboolean)</td>
    </tr>
    <tr>
@@ -176,7 +179,7 @@ in your composer.json file:

 ```json
 "require": {
-    "danielstjules/stringy": "~2.4"
+    "danielstjules/stringy": "~3.0"
 }
 ```

@@ -433,7 +436,7 @@ default, the comparison is case-sensitive, but can be made insensitive by
 setting $caseSensitive to false.

 ```php
-s('fòôbàř')->endsWith('bàř', true); // true
+s('fòôbàř')->endsWith('bàř'); // true
 ```

 ##### endsWithAny(string[] $substrings [, boolean $caseSensitive = true ])
@@ -443,7 +446,7 @@ By default, the comparison is case-sensitive, but can be made insensitive
 by setting $caseSensitive to false.

 ```php
-s('fòôbàř')->endsWith(['bàř', 'baz'], true); // true
+s('fòôbàř')->endsWithAny(['bàř', 'baz']); // true
 ```

 ##### ensureLeft(string $substring)
@@ -818,26 +821,6 @@ is also converted to lowercase.
 s('Using strings like fòô bàř')->slugify(); // 'using-strings-like-foo-bar'
 ```

-##### startsWith(string $substring [, boolean $caseSensitive = true ])
-
-Returns true if the string begins with $substring, false otherwise.
-By default, the comparison is case-sensitive, but can be made insensitive
-by setting $caseSensitive to false.
-
-```php
-s('FÒÔbàřbaz')->startsWith('fòôbàř', false); // true
-```
-
-##### startsWithAny(string[] $substrings [, boolean $caseSensitive = true ])
-
-Returns true if the string begins with any of $substrings, false
-otherwise. By default the comparison is case-sensitive, but can be made
-insensitive by setting $caseSensitive to false.
-
-```php
-s('FÒÔbàřbaz')->startsWith(['fòô', 'bàř'], false); // true
-```
-
 ##### slice(int $start [, int $end ])

 Returns the substring beginning at $start, and up to, but not including
@@ -859,6 +842,26 @@ results.
 s('foo,bar,baz')->split(',', 2); // ['foo', 'bar']
 ```

+##### startsWith(string $substring [, boolean $caseSensitive = true ])
+
+Returns true if the string begins with $substring, false otherwise.
+By default, the comparison is case-sensitive, but can be made insensitive
+by setting $caseSensitive to false.
+
+```php
+s('FÒÔbàřbaz')->startsWith('fòôbàř', false); // true
+```
+
+##### startsWithAny(string[] $substrings [, boolean $caseSensitive = true ])
+
+Returns true if the string begins with any of $substrings, false
+otherwise. By default the comparison is case-sensitive, but can be made
+insensitive by setting $caseSensitive to false.
+
+```php
+s('FÒÔbàřbaz')->startsWithAny(['fòô', 'bàř'], false); // true
+```
+
 ##### stripWhitespace()

 Strip all whitespace characters. This includes tabs and newline
@@ -916,14 +919,19 @@ s('i like to watch television')->titleize($ignore);
 // 'I Like to Watch Television'
 ```

-##### toAscii()
+##### toAscii([, string $locale = 'en' [, bool $removeUnsupported = true ]])

 Returns an ASCII version of the string. A set of non-ASCII characters are
 replaced with their closest ASCII counterparts, and the rest are removed
-unless instructed otherwise.
+by default. The language or locale of the source string can be supplied
+for language-specific transliteration in any of the following formats:
+en, en_GB, or en-GB. For example, passing "de" results in "äöü" mapping
+to "aeoeue" rather than "aou" as in other languages.

 ```php
 s('fòôbàř')->toAscii(); // 'foobar'
+s('äöü')->toAscii(); // 'aou'
+s('äöü')->toAscii('de'); // 'aeoeue'
 ```

 ##### toBoolean()
--- a/composer.json
+++ b/composer.json
@@ -15,7 +15,7 @@
        }
    ],
    "require": {
-        "php": ">=5.3.0",
+        "php": ">=5.4.0",
        "symfony/polyfill-mbstring": "~1.1"
    },
    "require-dev": {
--- a/src/StaticStringy.php
+++ b/src/StaticStringy.php
@@ -16,13 +16,14 @@ use ReflectionMethod;
 * @method static string chars(string $str, string $encoding = null)
 * @method static string collapseWhitespace(string $str, string $encoding = null)
 * @method static bool contains(string $str, string $needle, bool $caseSensitive = true, string $encoding = null)
- * @method static bool containsAll(string $str, string $needle, bool $caseSensitive = true, string $encoding = null)
- * @method static bool containsAny(string $str, string $needle, bool $caseSensitive = true, string $encoding = null)
+ * @method static bool containsAll(string $str, string[] $needle, bool $caseSensitive = true, string $encoding = null)
+ * @method static bool containsAny(string $str, string[] $needle, bool $caseSensitive = true, string $encoding = null)
 * @method static int count(string $str, string $encoding = null)
 * @method static int countSubstr(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
 * @method static string dasherize(string $str, string $encoding = null)
 * @method static string delimit(string $str, string $delimiter, string $encoding = null)
 * @method static bool endsWith(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
+ * @method static bool endsWithAny(string $str, string[] $substrings, bool $caseSensitive = true, string $encoding = null)
 * @method static string ensureLeft(string $str, string $substring, string $encoding = null)
 * @method static string ensureRight(string $str, string $substring, string $encoding = null)
 * @method static string first(string $str, int $n, string $encoding = null)
@@ -45,7 +46,7 @@ use ReflectionMethod;
 * @method static bool isUpperCase(string $str, string $encoding = null)
 * @method static string last(string $str, string $encoding = null)
 * @method static int length(string $str, string $encoding = null)
- * @method static Stringy[] lines(string $str, string $encoding = null)
+ * @method static string[] lines(string $str, string $encoding = null)
 * @method static string longestCommonPrefix(string $str, string $otherStr, string $encoding = null)
 * @method static string longestCommonSuffix(string $str, string $otherStr, string $encoding = null)
 * @method static string longestCommonSubstring(string $str, string $otherStr, string $encoding = null)
@@ -64,15 +65,17 @@ use ReflectionMethod;
 * @method static string safeTruncate(string $str, int $length, string $substring = '', string $encoding = null)
 * @method static string shuffle(string $str, string $encoding = null)
 * @method static string slugify(string $str, string $replacement = '-', string $encoding = null)
- * @method static bool startsWith(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
 * @method static string slice(string $str, int $start, int $end = null, string $encoding = null)
 * @method static string split(string $str, string $pattern, int $limit = null, string $encoding = null)
+ * @method static bool startsWith(string $str, string $substring, bool $caseSensitive = true, string $encoding = null)
+ * @method static bool startsWithAny(string $str, string[] $substrings, bool $caseSensitive = true, string $encoding = null)
+ * @method static string stripWhitespace(string $str, string $encoding = null)
 * @method static string substr(string $str, int $start, int $length = null, string $encoding = null)
 * @method static string surround(string $str, string $substring, string $encoding = null)
 * @method static string swapCase(string $str, string $encoding = null)
 * @method static string tidy(string $str, string $encoding = null)
 * @method static string titleize(string $str, string $encoding = null)
- * @method static string toAscii(string $str, bool $removeUnsupported = true, string $encoding = null)
+ * @method static string toAscii(string $str, string $language = 'en', bool $removeUnsupported = true, string $encoding = null)
 * @method static bool toBoolean(string $str, string $encoding = null)
 * @method static string toLowerCase(string $str, string $encoding = null)
 * @method static string toSpaces(string $str, int $tabLength = 4, string $encoding = null)
@@ -143,6 +146,16 @@ class StaticStringy

        $stringy = Stringy::create($str, $encoding);

-        return call_user_func_array(array($stringy, $name), $args);
+        $result = call_user_func_array([$stringy, $name], $args);
+
+        $cast = function($val) {
+            if (is_object($val) && $val instanceof Stringy) {
+                return (string) $val;
+            } else {
+                return $val;
+            }
+        };
+
+        return is_array($result) ? array_map($cast, $result) : $cast($result);
    }
 }
--- a/src/Stringy.php
+++ b/src/Stringy.php
@@ -174,7 +174,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     */
    public function chars()
    {
-        $chars = array();
+        $chars = [];
        for ($i = 0, $l = $this->length(); $i < $l; $i++) {
            $chars[] = $this->at($i)->str;
        }
@@ -219,9 +219,9 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     * default the comparison is case-sensitive, but can be made insensitive by
     * setting $caseSensitive to false.
     *
-     * @param  array  $needles       Substrings to look for
-     * @param  bool   $caseSensitive Whether or not to enforce case-sensitivity
-     * @return bool   Whether or not $str contains $needle
+     * @param  string[]  $needles       Substrings to look for
+     * @param  bool      $caseSensitive Whether or not to enforce case-sensitivity
+     * @return bool      Whether or not $str contains $needle
     */
    public function containsAll($needles, $caseSensitive = true)
    {
@@ -243,9 +243,9 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     * default the comparison is case-sensitive, but can be made insensitive by
     * setting $caseSensitive to false.
     *
-     * @param  array  $needles       Substrings to look for
-     * @param  bool   $caseSensitive Whether or not to enforce case-sensitivity
-     * @return bool   Whether or not $str contains $needle
+     * @param  string[] $needles       Substrings to look for
+     * @param  bool     $caseSensitive Whether or not to enforce case-sensitivity
+     * @return bool     Whether or not $str contains $needle
     */
    public function containsAny($needles, $caseSensitive = true)
    {
@@ -516,7 +516,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     */
    public function humanize()
    {
-        $str = str_replace(array('_id', '_'), array('', ' '), $this->str);
+        $str = str_replace(['_id', '_'], ['', ' '], $this->str);

        return static::create($str, $this->encoding)->trim()->upperCaseFirst();
    }
@@ -925,7 +925,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     */
    public function pad($length, $padStr = ' ', $padType = 'right')
    {
-        if (!in_array($padType, array('left', 'right', 'both'))) {
+        if (!in_array($padType, ['left', 'right', 'both'])) {
            throw new InvalidArgumentException('Pad expects $padType ' .
                "to be one of 'left', 'right' or 'both'");
        }
@@ -1180,7 +1180,8 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     * by setting $caseSensitive to false.
     *
     * @param  string $substring     The substring to look for
-     * @param  bool   $caseSensitive Whether or not to enforce case-sensitivity
+     * @param  bool   $caseSensitive Whether or not to enforce
+     *                               case-sensitivity
     * @return bool   Whether or not $str starts with $substring
     */
    public function startsWith($substring, $caseSensitive = true)
@@ -1259,13 +1260,13 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
    public function split($pattern, $limit = null)
    {
        if ($limit === 0) {
-            return array();
+            return [];
        }

        // mb_split errors when supplied an empty pattern in < PHP 5.4.13
        // and HHVM < 3.8
        if ($pattern === '') {
-            return array(static::create($this->str, $this->encoding));
+            return [static::create($this->str, $this->encoding)];
        }

        $regexEncoding = $this->regexEncoding();
@@ -1337,7 +1338,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     */
    public function surround($substring)
    {
-        $str = implode('', array($substring, $this->str, $substring));
+        $str = implode('', [$substring, $this->str, $substring]);

        return static::create($str, $this->encoding);
    }
@@ -1376,17 +1377,17 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
     */
    public function tidy()
    {
-        $str = preg_replace(array(
+        $str = preg_replace([
            '/\x{2026}/u',
            '/[\x{201C}\x{201D}]/u',
            '/[\x{2018}\x{2019}]/u',
            '/[\x{2013}\x{2014}]/u',
-        ), array(
+        ], [
            '...',
            '"',
            "'",
            '-',
-        ), $this->str);
+        ], $this->str);

        return static::create($str, $this->encoding);
    }
@@ -1424,16 +1425,25 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
    /**
     * Returns an ASCII version of the string. A set of non-ASCII characters are
     * replaced with their closest ASCII counterparts, and the rest are removed
-     * unless instructed otherwise.
+     * by default. The language or locale of the source string can be supplied
+     * for language-specific transliteration in any of the following formats:
+     * en, en_GB, or en-GB. For example, passing "de" results in "äöü" mapping
+     * to "aeoeue" rather than "aou" as in other languages.
     *
+     * @param  string  $language          Language of the source string
     * @param  bool    $removeUnsupported Whether or not to remove the
     *                                    unsupported characters
     * @return static Object whose $str contains only ASCII characters
     */
-    public function toAscii($removeUnsupported = true)
+    public function toAscii($language = 'en', $removeUnsupported = true)
    {
        $str = $this->str;

+        $langSpecific = $this->langSpecificCharsArray($language);
+        if (!empty($langSpecific)) {
+            $str = str_replace($langSpecific[0], $langSpecific[1], $str);
+        }
+
        foreach ($this->charsArray() as $key => $value) {
            $str = str_replace($value, $key, $str);
        }
@@ -1459,7 +1469,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
    public function toBoolean()
    {
        $key = $this->toLowerCase()->str;
-        $map = array(
+        $map = [
            'true'  => true,
            '1'     => true,
            'on'    => true,
@@ -1468,7 +1478,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
            '0'     => false,
            'off'   => false,
            'no'    => false
-        );
+        ];

        if (array_key_exists($key, $map)) {
            return $map[$key];
@@ -1670,171 +1680,204 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess
        static $charsArray;
        if (isset($charsArray)) return $charsArray;

-        return $charsArray = array(
-            '0'    => array('°', '₀', '۰', '０'),
-            '1'    => array('¹', '₁', '۱', '１'),
-            '2'    => array('²', '₂', '۲', '２'),
-            '3'    => array('³', '₃', '۳', '３'),
-            '4'    => array('⁴', '₄', '۴', '٤', '４'),
-            '5'    => array('⁵', '₅', '۵', '٥', '５'),
-            '6'    => array('⁶', '₆', '۶', '٦', '６'),
-            '7'    => array('⁷', '₇', '۷', '７'),
-            '8'    => array('⁸', '₈', '۸', '８'),
-            '9'    => array('⁹', '₉', '۹', '９'),
-            'a'    => array('à', 'á', 'ả', 'ã', 'ạ', 'ă', 'ắ', 'ằ', 'ẳ', 'ẵ',
-                            'ặ', 'â', 'ấ', 'ầ', 'ẩ', 'ẫ', 'ậ', 'ā', 'ą', 'å',
-                            'α', 'ά', 'ἀ', 'ἁ', 'ἂ', 'ἃ', 'ἄ', 'ἅ', 'ἆ', 'ἇ',
-                            'ᾀ', 'ᾁ', 'ᾂ', 'ᾃ', 'ᾄ', 'ᾅ', 'ᾆ', 'ᾇ', 'ὰ', 'ά',
-                            'ᾰ', 'ᾱ', 'ᾲ', 'ᾳ', 'ᾴ', 'ᾶ', 'ᾷ', 'а', 'أ', 'အ',
-                            'ာ', 'ါ', 'ǻ', 'ǎ', 'ª', 'ა', 'अ', 'ا', 'ａ'),
-            'b'    => array('б', 'β', 'Ъ', 'Ь', 'ب', 'ဗ', 'ბ', 'ｂ'),
-            'c'    => array('ç', 'ć', 'č', 'ĉ', 'ċ', 'ｃ'),
-            'd'    => array('ď', 'ð', 'đ', 'ƌ', 'ȡ', 'ɖ', 'ɗ', 'ᵭ', 'ᶁ', 'ᶑ',
-                            'д', 'δ', 'د', 'ض', 'ဍ', 'ဒ', 'დ', 'ｄ'),
-            'e'    => array('é', 'è', 'ẻ', 'ẽ', 'ẹ', 'ê', 'ế', 'ề', 'ể', 'ễ',
-                            'ệ', 'ë', 'ē', 'ę', 'ě', 'ĕ', 'ė', 'ε', 'έ', 'ἐ',
-                            'ἑ', 'ἒ', 'ἓ', 'ἔ', 'ἕ', 'ὲ', 'έ', 'е', 'ё', 'э',
-                            'є', 'ə', 'ဧ', 'ေ', 'ဲ', 'ე', 'ए', 'إ', 'ئ', 'ｅ'),
-            'f'    => array('ф', 'φ', 'ف', 'ƒ', 'ფ', 'ｆ'),
-            'g'    => array('ĝ', 'ğ', 'ġ', 'ģ', 'г', 'ґ', 'γ', 'ဂ', 'გ', 'گ',
-                            'ｇ'),
-            'h'    => array('ĥ', 'ħ', 'η', 'ή', 'ح', 'ه', 'ဟ', 'ှ', 'ჰ', 'ｈ'),
-            'i'    => array('í', 'ì', 'ỉ', 'ĩ', 'ị', 'î', 'ï', 'ī', 'ĭ', 'į',
-                            'ı', 'ι', 'ί', 'ϊ', 'ΐ', 'ἰ', 'ἱ', 'ἲ', 'ἳ', 'ἴ',
-                            'ἵ', 'ἶ', 'ἷ', 'ὶ', 'ί', 'ῐ', 'ῑ', 'ῒ', 'ΐ', 'ῖ',
-                            'ῗ', 'і', 'ї', 'и', 'ဣ', 'ိ', 'ီ', 'ည်', 'ǐ', 'ი',
-                            'इ', 'ی', 'ｉ'),
-            'j'    => array('ĵ', 'ј', 'Ј', 'ჯ', 'ج', 'ｊ'),
-            'k'    => array('ķ', 'ĸ', 'к', 'κ', 'Ķ', 'ق', 'ك', 'က', 'კ', 'ქ',
-                            'ک', 'ｋ'),
-            'l'    => array('ł', 'ľ', 'ĺ', 'ļ', 'ŀ', 'л', 'λ', 'ل', 'လ', 'ლ',
-                            'ｌ'),
-            'm'    => array('м', 'μ', 'م', 'မ', 'მ', 'ｍ'),
-            'n'    => array('ñ', 'ń', 'ň', 'ņ', 'ŉ', 'ŋ', 'ν', 'н', 'ن', 'န',
-                            'ნ', 'ｎ'),
-            'o'    => array('ó', 'ò', 'ỏ', 'õ', 'ọ', 'ô', 'ố', 'ồ', 'ổ', 'ỗ',
-                            'ộ', 'ơ', 'ớ', 'ờ', 'ở', 'ỡ', 'ợ', 'ø', 'ō', 'ő',
-                            'ŏ', 'ο', 'ὀ', 'ὁ', 'ὂ', 'ὃ', 'ὄ', 'ὅ', 'ὸ', 'ό',
-                            'о', 'و', 'θ', 'ို', 'ǒ', 'ǿ', 'º', 'ო', 'ओ', 'ｏ'),
-            'p'    => array('п', 'π', 'ပ', 'პ', 'پ', 'ｐ'),
-            'q'    => array('ყ', 'ｑ'),
-            'r'    => array('ŕ', 'ř', 'ŗ', 'р', 'ρ', 'ر', 'რ', 'ｒ'),
-            's'    => array('ś', 'š', 'ş', 'с', 'σ', 'ș', 'ς', 'س', 'ص', 'စ',
-                            'ſ', 'ს', 'ｓ'),
-            't'    => array('ť', 'ţ', 'т', 'τ', 'ț', 'ت', 'ط', 'ဋ', 'တ', 'ŧ',
-                            'თ', 'ტ', 'ｔ'),
-            'u'    => array('ú', 'ù', 'ủ', 'ũ', 'ụ', 'ư', 'ứ', 'ừ', 'ử', 'ữ',
-                            'ự', 'û', 'ū', 'ů', 'ű', 'ŭ', 'ų', 'µ', 'у', 'ဉ',
-                            'ု', 'ူ', 'ǔ', 'ǖ', 'ǘ', 'ǚ', 'ǜ', 'უ', 'उ', 'ｕ',
-                            'ў'),
-            'v'    => array('в', 'ვ', 'ϐ', 'ｖ'),
-            'w'    => array('ŵ', 'ω', 'ώ', 'ဝ', 'ွ', 'ｗ'),
-            'x'    => array('χ', 'ξ', 'ｘ'),
-            'y'    => array('ý', 'ỳ', 'ỷ', 'ỹ', 'ỵ', 'ÿ', 'ŷ', 'й', 'ы', 'υ',
-                            'ϋ', 'ύ', 'ΰ', 'ي', 'ယ', 'ｙ'),
-            'z'    => array('ź', 'ž', 'ż', 'з', 'ζ', 'ز', 'ဇ', 'ზ', 'ｚ'),
-            'aa'   => array('ع', 'आ', 'آ'),
-            'ae'   => array('ä', 'æ', 'ǽ'),
-            'ai'   => array('ऐ'),
-            'at'   => array('@'),
-            'ch'   => array('ч', 'ჩ', 'ჭ', 'چ'),
-            'dj'   => array('ђ', 'đ'),
-            'dz'   => array('џ', 'ძ'),
-            'ei'   => array('ऍ'),
-            'gh'   => array('غ', 'ღ'),
-            'ii'   => array('ई'),
-            'ij'   => array('ĳ'),
-            'kh'   => array('х', 'خ', 'ხ'),
-            'lj'   => array('љ'),
-            'nj'   => array('њ'),
-            'oe'   => array('ö', 'œ', 'ؤ'),
-            'oi'   => array('ऑ'),
-            'oii'  => array('ऒ'),
-            'ps'   => array('ψ'),
-            'sh'   => array('ш', 'შ', 'ش'),
-            'shch' => array('щ'),
-            'ss'   => array('ß'),
-            'sx'   => array('ŝ'),
-            'th'   => array('þ', 'ϑ', 'ث', 'ذ', 'ظ'),
-            'ts'   => array('ц', 'ც', 'წ'),
-            'ue'   => array('ü'),
-            'uu'   => array('ऊ'),
-            'ya'   => array('я'),
-            'yu'   => array('ю'),
-            'zh'   => array('ж', 'ჟ', 'ژ'),
-            '(c)'  => array('©'),
-            'A'    => array('Á', 'À', 'Ả', 'Ã', 'Ạ', 'Ă', 'Ắ', 'Ằ', 'Ẳ', 'Ẵ',
-                            'Ặ', 'Â', 'Ấ', 'Ầ', 'Ẩ', 'Ẫ', 'Ậ', 'Å', 'Ā', 'Ą',
-                            'Α', 'Ά', 'Ἀ', 'Ἁ', 'Ἂ', 'Ἃ', 'Ἄ', 'Ἅ', 'Ἆ', 'Ἇ',
-                            'ᾈ', 'ᾉ', 'ᾊ', 'ᾋ', 'ᾌ', 'ᾍ', 'ᾎ', 'ᾏ', 'Ᾰ', 'Ᾱ',
-                            'Ὰ', 'Ά', 'ᾼ', 'А', 'Ǻ', 'Ǎ', 'Ａ'),
-            'B'    => array('Б', 'Β', 'ब', 'Ｂ'),
-            'C'    => array('Ç','Ć', 'Č', 'Ĉ', 'Ċ', 'Ｃ'),
-            'D'    => array('Ď', 'Ð', 'Đ', 'Ɖ', 'Ɗ', 'Ƌ', 'ᴅ', 'ᴆ', 'Д', 'Δ',
-                            'Ｄ'),
-            'E'    => array('É', 'È', 'Ẻ', 'Ẽ', 'Ẹ', 'Ê', 'Ế', 'Ề', 'Ể', 'Ễ',
-                            'Ệ', 'Ë', 'Ē', 'Ę', 'Ě', 'Ĕ', 'Ė', 'Ε', 'Έ', 'Ἐ',
-                            'Ἑ', 'Ἒ', 'Ἓ', 'Ἔ', 'Ἕ', 'Έ', 'Ὲ', 'Е', 'Ё', 'Э',
-                            'Є', 'Ə', 'Ｅ'),
-            'F'    => array('Ф', 'Φ', 'Ｆ'),
-            'G'    => array('Ğ', 'Ġ', 'Ģ', 'Г', 'Ґ', 'Γ', 'Ｇ'),
-            'H'    => array('Η', 'Ή', 'Ħ', 'Ｈ'),
-            'I'    => array('Í', 'Ì', 'Ỉ', 'Ĩ', 'Ị', 'Î', 'Ï', 'Ī', 'Ĭ', 'Į',
-                            'İ', 'Ι', 'Ί', 'Ϊ', 'Ἰ', 'Ἱ', 'Ἳ', 'Ἴ', 'Ἵ', 'Ἶ',
-                            'Ἷ', 'Ῐ', 'Ῑ', 'Ὶ', 'Ί', 'И', 'І', 'Ї', 'Ǐ', 'ϒ',
-                            'Ｉ'),
-            'J'    => array('Ｊ'),
-            'K'    => array('К', 'Κ', 'Ｋ'),
-            'L'    => array('Ĺ', 'Ł', 'Л', 'Λ', 'Ļ', 'Ľ', 'Ŀ', 'ल', 'Ｌ'),
-            'M'    => array('М', 'Μ', 'Ｍ'),
-            'N'    => array('Ń', 'Ñ', 'Ň', 'Ņ', 'Ŋ', 'Н', 'Ν', 'Ｎ'),
-            'O'    => array('Ó', 'Ò', 'Ỏ', 'Õ', 'Ọ', 'Ô', 'Ố', 'Ồ', 'Ổ', 'Ỗ',
-                            'Ộ', 'Ơ', 'Ớ', 'Ờ', 'Ở', 'Ỡ', 'Ợ', 'Ø', 'Ō', 'Ő',
-                            'Ŏ', 'Ο', 'Ό', 'Ὀ', 'Ὁ', 'Ὂ', 'Ὃ', 'Ὄ', 'Ὅ', 'Ὸ',
-                            'Ό', 'О', 'Θ', 'Ө', 'Ǒ', 'Ǿ', 'Ｏ'),
-            'P'    => array('П', 'Π', 'Ｐ'),
-            'Q'    => array('Ｑ'),
-            'R'    => array('Ř', 'Ŕ', 'Р', 'Ρ', 'Ŗ', 'Ｒ'),
-            'S'    => array('Ş', 'Ŝ', 'Ș', 'Š', 'Ś', 'С', 'Σ', 'Ｓ'),
-            'T'    => array('Ť', 'Ţ', 'Ŧ', 'Ț', 'Т', 'Τ', 'Ｔ'),
-            'U'    => array('Ú', 'Ù', 'Ủ', 'Ũ', 'Ụ', 'Ư', 'Ứ', 'Ừ', 'Ử', 'Ữ',
-                            'Ự', 'Û', 'Ū', 'Ů', 'Ű', 'Ŭ', 'Ų', 'У', 'Ǔ', 'Ǖ',
-                            'Ǘ', 'Ǚ', 'Ǜ', 'Ｕ', 'Ў'),
-            'V'    => array('В', 'Ｖ'),
-            'W'    => array('Ω', 'Ώ', 'Ŵ', 'Ｗ'),
-            'X'    => array('Χ', 'Ξ', 'Ｘ'),
-            'Y'    => array('Ý', 'Ỳ', 'Ỷ', 'Ỹ', 'Ỵ', 'Ÿ', 'Ῠ', 'Ῡ', 'Ὺ', 'Ύ',
-                            'Ы', 'Й', 'Υ', 'Ϋ', 'Ŷ', 'Ｙ'),
-            'Z'    => array('Ź', 'Ž', 'Ż', 'З', 'Ζ', 'Ｚ'),
-            'AE'   => array('Ä', 'Æ', 'Ǽ'),
-            'CH'   => array('Ч'),
-            'DJ'   => array('Ђ'),
-            'DZ'   => array('Џ'),
-            'GX'   => array('Ĝ'),
-            'HX'   => array('Ĥ'),
-            'IJ'   => array('Ĳ'),
-            'JX'   => array('Ĵ'),
-            'KH'   => array('Х'),
-            'LJ'   => array('Љ'),
-            'NJ'   => array('Њ'),
-            'OE'   => array('Ö', 'Œ'),
-            'PS'   => array('Ψ'),
-            'SH'   => array('Ш'),
-            'SHCH' => array('Щ'),
-            'SS'   => array('ẞ'),
-            'TH'   => array('Þ'),
-            'TS'   => array('Ц'),
-            'UE'   => array('Ü'),
-            'YA'   => array('Я'),
-            'YU'   => array('Ю'),
-            'ZH'   => array('Ж'),
-            ' '    => array("\xC2\xA0", "\xE2\x80\x80", "\xE2\x80\x81",
-                            "\xE2\x80\x82", "\xE2\x80\x83", "\xE2\x80\x84",
-                            "\xE2\x80\x85", "\xE2\x80\x86", "\xE2\x80\x87",
-                            "\xE2\x80\x88", "\xE2\x80\x89", "\xE2\x80\x8A",
-                            "\xE2\x80\xAF", "\xE2\x81\x9F", "\xE3\x80\x80",
-                            "\xEF\xBE\xA0"),
-        );
+        return $charsArray = [
+            '0'     => ['°', '₀', '۰', '０'],
+            '1'     => ['¹', '₁', '۱', '１'],
+            '2'     => ['²', '₂', '۲', '２'],
+            '3'     => ['³', '₃', '۳', '３'],
+            '4'     => ['⁴', '₄', '۴', '٤', '４'],
+            '5'     => ['⁵', '₅', '۵', '٥', '５'],
+            '6'     => ['⁶', '₆', '۶', '٦', '６'],
+            '7'     => ['⁷', '₇', '۷', '７'],
+            '8'     => ['⁸', '₈', '۸', '８'],
+            '9'     => ['⁹', '₉', '۹', '９'],
+            'a'     => ['à', 'á', 'ả', 'ã', 'ạ', 'ă', 'ắ', 'ằ', 'ẳ', 'ẵ',
+                        'ặ', 'â', 'ấ', 'ầ', 'ẩ', 'ẫ', 'ậ', 'ā', 'ą', 'å',
+                        'α', 'ά', 'ἀ', 'ἁ', 'ἂ', 'ἃ', 'ἄ', 'ἅ', 'ἆ', 'ἇ',
+                        'ᾀ', 'ᾁ', 'ᾂ', 'ᾃ', 'ᾄ', 'ᾅ', 'ᾆ', 'ᾇ', 'ὰ', 'ά',
+                        'ᾰ', 'ᾱ', 'ᾲ', 'ᾳ', 'ᾴ', 'ᾶ', 'ᾷ', 'а', 'أ', 'အ',
+                        'ာ', 'ါ', 'ǻ', 'ǎ', 'ª', 'ა', 'अ', 'ا', 'ａ', 'ä'],
+            'b'     => ['б', 'β', 'Ъ', 'Ь', 'ب', 'ဗ', 'ბ', 'ｂ'],
+            'c'     => ['ç', 'ć', 'č', 'ĉ', 'ċ', 'ｃ'],
+            'd'     => ['ď', 'ð', 'đ', 'ƌ', 'ȡ', 'ɖ', 'ɗ', 'ᵭ', 'ᶁ', 'ᶑ',
+                        'д', 'δ', 'د', 'ض', 'ဍ', 'ဒ', 'დ', 'ｄ'],
+            'e'     => ['é', 'è', 'ẻ', 'ẽ', 'ẹ', 'ê', 'ế', 'ề', 'ể', 'ễ',
+                        'ệ', 'ë', 'ē', 'ę', 'ě', 'ĕ', 'ė', 'ε', 'έ', 'ἐ',
+                        'ἑ', 'ἒ', 'ἓ', 'ἔ', 'ἕ', 'ὲ', 'έ', 'е', 'ё', 'э',
+                        'є', 'ə', 'ဧ', 'ေ', 'ဲ', 'ე', 'ए', 'إ', 'ئ', 'ｅ'],
+            'f'     => ['ф', 'φ', 'ف', 'ƒ', 'ფ', 'ｆ'],
+            'g'     => ['ĝ', 'ğ', 'ġ', 'ģ', 'г', 'ґ', 'γ', 'ဂ', 'გ', 'گ',
+                        'ｇ'],
+            'h'     => ['ĥ', 'ħ', 'η', 'ή', 'ح', 'ه', 'ဟ', 'ှ', 'ჰ', 'ｈ'],
+            'i'     => ['í', 'ì', 'ỉ', 'ĩ', 'ị', 'î', 'ï', 'ī', 'ĭ', 'į',
+                        'ı', 'ι', 'ί', 'ϊ', 'ΐ', 'ἰ', 'ἱ', 'ἲ', 'ἳ', 'ἴ',
+                        'ἵ', 'ἶ', 'ἷ', 'ὶ', 'ί', 'ῐ', 'ῑ', 'ῒ', 'ΐ', 'ῖ',
+                        'ῗ', 'і', 'ї', 'и', 'ဣ', 'ိ', 'ီ', 'ည်', 'ǐ', 'ი',
+                        'इ', 'ی', 'ｉ'],
+            'j'     => ['ĵ', 'ј', 'Ј', 'ჯ', 'ج', 'ｊ'],
+            'k'     => ['ķ', 'ĸ', 'к', 'κ', 'Ķ', 'ق', 'ك', 'က', 'კ', 'ქ',
+                        'ک', 'ｋ'],
+            'l'     => ['ł', 'ľ', 'ĺ', 'ļ', 'ŀ', 'л', 'λ', 'ل', 'လ', 'ლ',
+                        'ｌ'],
+            'm'     => ['м', 'μ', 'م', 'မ', 'მ', 'ｍ'],
+            'n'     => ['ñ', 'ń', 'ň', 'ņ', 'ŉ', 'ŋ', 'ν', 'н', 'ن', 'န',
+                        'ნ', 'ｎ'],
+            'o'     => ['ó', 'ò', 'ỏ', 'õ', 'ọ', 'ô', 'ố', 'ồ', 'ổ', 'ỗ',
+                        'ộ', 'ơ', 'ớ', 'ờ', 'ở', 'ỡ', 'ợ', 'ø', 'ō', 'ő',
+                        'ŏ', 'ο', 'ὀ', 'ὁ', 'ὂ', 'ὃ', 'ὄ', 'ὅ', 'ὸ', 'ό',
+                        'о', 'و', 'θ', 'ို', 'ǒ', 'ǿ', 'º', 'ო', 'ओ', 'ｏ',
+                        'ö'],
+            'p'     => ['п', 'π', 'ပ', 'პ', 'پ', 'ｐ'],
+            'q'     => ['ყ', 'ｑ'],
+            'r'     => ['ŕ', 'ř', 'ŗ', 'р', 'ρ', 'ر', 'რ', 'ｒ'],
+            's'     => ['ś', 'š', 'ş', 'с', 'σ', 'ș', 'ς', 'س', 'ص', 'စ',
+                        'ſ', 'ს', 'ｓ'],
+            't'     => ['ť', 'ţ', 'т', 'τ', 'ț', 'ت', 'ط', 'ဋ', 'တ', 'ŧ',
+                        'თ', 'ტ', 'ｔ'],
+            'u'     => ['ú', 'ù', 'ủ', 'ũ', 'ụ', 'ư', 'ứ', 'ừ', 'ử', 'ữ',
+                        'ự', 'û', 'ū', 'ů', 'ű', 'ŭ', 'ų', 'µ', 'у', 'ဉ',
+                        'ု', 'ူ', 'ǔ', 'ǖ', 'ǘ', 'ǚ', 'ǜ', 'უ', 'उ', 'ｕ',
+                        'ў', 'ü'],
+            'v'     => ['в', 'ვ', 'ϐ', 'ｖ'],
+            'w'     => ['ŵ', 'ω', 'ώ', 'ဝ', 'ွ', 'ｗ'],
+            'x'     => ['χ', 'ξ', 'ｘ'],
+            'y'     => ['ý', 'ỳ', 'ỷ', 'ỹ', 'ỵ', 'ÿ', 'ŷ', 'й', 'ы', 'υ',
+                        'ϋ', 'ύ', 'ΰ', 'ي', 'ယ', 'ｙ'],
+            'z'     => ['ź', 'ž', 'ż', 'з', 'ζ', 'ز', 'ဇ', 'ზ', 'ｚ'],
+            'aa'    => ['ع', 'आ', 'آ'],
+            'ae'    => ['æ', 'ǽ'],
+            'ai'    => ['ऐ'],
+            'at'    => ['@'],
+            'ch'    => ['ч', 'ჩ', 'ჭ', 'چ'],
+            'dj'    => ['ђ', 'đ'],
+            'dz'    => ['џ', 'ძ'],
+            'ei'    => ['ऍ'],
+            'gh'    => ['غ', 'ღ'],
+            'ii'    => ['ई'],
+            'ij'    => ['ĳ'],
+            'kh'    => ['х', 'خ', 'ხ'],
+            'lj'    => ['љ'],
+            'nj'    => ['њ'],
+            'oe'    => ['œ', 'ؤ'],
+            'oi'    => ['ऑ'],
+            'oii'   => ['ऒ'],
+            'ps'    => ['ψ'],
+            'sh'    => ['ш', 'შ', 'ش'],
+            'shch'  => ['щ'],
+            'ss'    => ['ß'],
+            'sx'    => ['ŝ'],
+            'th'    => ['þ', 'ϑ', 'ث', 'ذ', 'ظ'],
+            'ts'    => ['ц', 'ც', 'წ'],
+            'uu'    => ['ऊ'],
+            'ya'    => ['я'],
+            'yu'    => ['ю'],
+            'zh'    => ['ж', 'ჟ', 'ژ'],
+            '(c)'   => ['©'],
+            'A'     => ['Á', 'À', 'Ả', 'Ã', 'Ạ', 'Ă', 'Ắ', 'Ằ', 'Ẳ', 'Ẵ',
+                        'Ặ', 'Â', 'Ấ', 'Ầ', 'Ẩ', 'Ẫ', 'Ậ', 'Å', 'Ā', 'Ą',
+                        'Α', 'Ά', 'Ἀ', 'Ἁ', 'Ἂ', 'Ἃ', 'Ἄ', 'Ἅ', 'Ἆ', 'Ἇ',
+                        'ᾈ', 'ᾉ', 'ᾊ', 'ᾋ', 'ᾌ', 'ᾍ', 'ᾎ', 'ᾏ', 'Ᾰ', 'Ᾱ',
+                        'Ὰ', 'Ά', 'ᾼ', 'А', 'Ǻ', 'Ǎ', 'Ａ', 'Ä'],
+            'B'     => ['Б', 'Β', 'ब', 'Ｂ'],
+            'C'     => ['Ç','Ć', 'Č', 'Ĉ', 'Ċ', 'Ｃ'],
+            'D'     => ['Ď', 'Ð', 'Đ', 'Ɖ', 'Ɗ', 'Ƌ', 'ᴅ', 'ᴆ', 'Д', 'Δ',
+                        'Ｄ'],
+            'E'     => ['É', 'È', 'Ẻ', 'Ẽ', 'Ẹ', 'Ê', 'Ế', 'Ề', 'Ể', 'Ễ',
+                        'Ệ', 'Ë', 'Ē', 'Ę', 'Ě', 'Ĕ', 'Ė', 'Ε', 'Έ', 'Ἐ',
+                        'Ἑ', 'Ἒ', 'Ἓ', 'Ἔ', 'Ἕ', 'Έ', 'Ὲ', 'Е', 'Ё', 'Э',
+                        'Є', 'Ə', 'Ｅ'],
+            'F'     => ['Ф', 'Φ', 'Ｆ'],
+            'G'     => ['Ğ', 'Ġ', 'Ģ', 'Г', 'Ґ', 'Γ', 'Ｇ'],
+            'H'     => ['Η', 'Ή', 'Ħ', 'Ｈ'],
+            'I'     => ['Í', 'Ì', 'Ỉ', 'Ĩ', 'Ị', 'Î', 'Ï', 'Ī', 'Ĭ', 'Į',
+                        'İ', 'Ι', 'Ί', 'Ϊ', 'Ἰ', 'Ἱ', 'Ἳ', 'Ἴ', 'Ἵ', 'Ἶ',
+                        'Ἷ', 'Ῐ', 'Ῑ', 'Ὶ', 'Ί', 'И', 'І', 'Ї', 'Ǐ', 'ϒ',
+                        'Ｉ'],
+            'J'     => ['Ｊ'],
+            'K'     => ['К', 'Κ', 'Ｋ'],
+            'L'     => ['Ĺ', 'Ł', 'Л', 'Λ', 'Ļ', 'Ľ', 'Ŀ', 'ल', 'Ｌ'],
+            'M'     => ['М', 'Μ', 'Ｍ'],
+            'N'     => ['Ń', 'Ñ', 'Ň', 'Ņ', 'Ŋ', 'Н', 'Ν', 'Ｎ'],
+            'O'     => ['Ó', 'Ò', 'Ỏ', 'Õ', 'Ọ', 'Ô', 'Ố', 'Ồ', 'Ổ', 'Ỗ',
+                        'Ộ', 'Ơ', 'Ớ', 'Ờ', 'Ở', 'Ỡ', 'Ợ', 'Ø', 'Ō', 'Ő',
+                        'Ŏ', 'Ο', 'Ό', 'Ὀ', 'Ὁ', 'Ὂ', 'Ὃ', 'Ὄ', 'Ὅ', 'Ὸ',
+                        'Ό', 'О', 'Θ', 'Ө', 'Ǒ', 'Ǿ', 'Ｏ', 'Ö'],
+            'P'     => ['П', 'Π', 'Ｐ'],
+            'Q'     => ['Ｑ'],
+            'R'     => ['Ř', 'Ŕ', 'Р', 'Ρ', 'Ŗ', 'Ｒ'],
+            'S'     => ['Ş', 'Ŝ', 'Ș', 'Š', 'Ś', 'С', 'Σ', 'Ｓ'],
+            'T'     => ['Ť', 'Ţ', 'Ŧ', 'Ț', 'Т', 'Τ', 'Ｔ'],
+            'U'     => ['Ú', 'Ù', 'Ủ', 'Ũ', 'Ụ', 'Ư', 'Ứ', 'Ừ', 'Ử', 'Ữ',
+                        'Ự', 'Û', 'Ū', 'Ů', 'Ű', 'Ŭ', 'Ų', 'У', 'Ǔ', 'Ǖ',
+                        'Ǘ', 'Ǚ', 'Ǜ', 'Ｕ', 'Ў', 'Ü'],
+            'V'     => ['В', 'Ｖ'],
+            'W'     => ['Ω', 'Ώ', 'Ŵ', 'Ｗ'],
+            'X'     => ['Χ', 'Ξ', 'Ｘ'],
+            'Y'     => ['Ý', 'Ỳ', 'Ỷ', 'Ỹ', 'Ỵ', 'Ÿ', 'Ῠ', 'Ῡ', 'Ὺ', 'Ύ',
+                        'Ы', 'Й', 'Υ', 'Ϋ', 'Ŷ', 'Ｙ'],
+            'Z'     => ['Ź', 'Ž', 'Ż', 'З', 'Ζ', 'Ｚ'],
+            'AE'    => ['Æ', 'Ǽ'],
+            'Ch'    => ['Ч'],
+            'Dj'    => ['Ђ'],
+            'Dz'    => ['Џ'],
+            'Gx'    => ['Ĝ'],
+            'Hx'    => ['Ĥ'],
+            'Ij'    => ['Ĳ'],
+            'Jx'    => ['Ĵ'],
+            'Kh'    => ['Х'],
+            'Lj'    => ['Љ'],
+            'Nj'    => ['Њ'],
+            'Oe'    => ['Œ'],
+            'Ps'    => ['Ψ'],
+            'Sh'    => ['Ш'],
+            'Shch'  => ['Щ'],
+            'Ss'    => ['ẞ'],
+            'Th'    => ['Þ'],
+            'Ts'    => ['Ц'],
+            'Ya'    => ['Я'],
+            'Yu'    => ['Ю'],
+            'Zh'    => ['Ж'],
+            ' '     => ["\xC2\xA0", "\xE2\x80\x80", "\xE2\x80\x81",
+                        "\xE2\x80\x82", "\xE2\x80\x83", "\xE2\x80\x84",
+                        "\xE2\x80\x85", "\xE2\x80\x86", "\xE2\x80\x87",
+                        "\xE2\x80\x88", "\xE2\x80\x89", "\xE2\x80\x8A",
+                        "\xE2\x80\xAF", "\xE2\x81\x9F", "\xE3\x80\x80",
+                        "\xEF\xBE\xA0"],
+        ];
+    }
+
+    /**
+     * Returns language-specific replacements for the toAscii() method.
+     * For example, German will map 'ä' to 'ae', while other languages
+     * will simply return 'a'.
+     *
+     * param  string $language Language of the source string
+     * @return array An array of replacements.
+     */
+    protected static function langSpecificCharsArray($language = 'en')
+    {
+        $split = preg_split('/[-_]/', $language);
+        $language = strtolower($split[0]);
+
+        static $charsArray = [];
+        if (isset($charsArray[$language])) {
+            return $charsArray[$language];
+        }
+
+        $languageSpecific = [
+            'de' => [
+                ['ä',  'ö',  'ü',  'Ä',  'Ö',  'Ü' ],
+                ['ae', 'oe', 'ue', 'AE', 'OE', 'UE'],
+            ]
+        ];
+
+        if (isset($languageSpecific[$language])) {
+            $charsArray[$language] = $languageSpecific[$language];
+        } else {
+            $charsArray[$language] = [];
+        }
+
+        return $charsArray[$language];
    }

    /**
@@ -1924,7 +1967,7 @@ class Stringy implements Countable, IteratorAggregate, ArrayAccess

    protected function supportsEncoding()
    {
-        $supported = array('UTF-8' => true, 'ASCII' => true);
+        $supported = ['UTF-8' => true, 'ASCII' => true];

        if (isset($supported[$this->encoding])) {
            return true;
--- a/tests/StaticStringyTest.php
+++ b/tests/StaticStringyTest.php
@@ -15,25 +15,38 @@ class StaticStringyTestCase extends PHPUnit_Framework_TestCase
    public function testEmptyArgsInvocation()
    {
        $result = S::toLowerCase();
-        $this->assertEquals('', (string) $result);
+        $this->assertEquals('', $result);
    }

    public function testInvocation()
    {
        $result = S::toLowerCase('FOOBAR');
-        $this->assertEquals('foobar', (string) $result);
+        $this->assertEquals('foobar', $result);
+        $this->assertInternalType('string', $result);
    }

    public function testPartialArgsInvocation()
    {
        $result = S::slice('foobar', 0, 3);
-        $this->assertEquals('foo', (string) $result);
+        $this->assertEquals('foo', $result);
+        $this->assertInternalType('string', $result);
    }

    public function testFullArgsInvocation()
    {
        $result = S::slice('fòôbàř', 0, 3, 'UTF-8');
-        $this->assertEquals('fòô', (string) $result);
+        $this->assertEquals('fòô', $result);
+        $this->assertInternalType('string', $result);
+    }
+
+    public function testArrayReturnValue()
+    {
+        $result = S::lines("a\nb");
+        $this->assertEquals(['a', 'b'], $result);
+        $this->assertInternalType('array', $result);
+        foreach ($result as $val) {
+            $this->assertInternalType('string', $val);
+        }
    }

    /**
--- a/tests/StringyTest.php
+++ b/tests/StringyTest.php
Author	SHA1	Message	Date
Daniel St. Jules	8b59cd2233	3.0.0	2017-03-08 19:52:40 -05:00
Daniel St. Jules	63d81901ad	Merge pull request #160 from danielstjules/3.x-dev 3.x	2017-03-08 19:44:04 -05:00
Daniel St. Jules	a2624d4969	Docs fixes	2017-03-08 19:23:05 -05:00
Daniel St. Jules	72102ae911	toAscii changes: rename locale to language, correct some transliterations	2017-03-08 19:16:09 -05:00
Daniel St. Jules	bf2a302aa1	Breaking change: Fix docs, force static methods to return strings rather than Stringy instances	2017-03-06 15:11:14 -05:00
Alexey Shockov	5303203a72	Return real strings from StaticStringy	2017-03-06 14:00:09 -05:00
Daniel St. Jules	e01ba7f848	Use short array syntax	2017-03-06 13:43:47 -05:00
Daniel St. Jules	f9f3b7f2f2	Link to 2.x documentation	2017-03-06 13:15:11 -05:00
Daniel St. Jules	75b0cd2e0d	Drop php 5.3 support	2017-03-06 13:14:15 -05:00
Daniel St. Jules	b0976c72b7	Fix #116 with breaking change: add locale parameter to toAscii This fixes a previous regression in handling of some umlaut characters, and commits a breaking change by adding the param before $removeUnsupported	2017-03-06 13:01:09 -05:00