voku / portable-utf8

src/voku/helper/UTF8.php

Doc Comments +6 added lines, -6 removed lines

@@ -2731,7 +2731,7 @@ 
   /**
    * Check if the input is binary... (is look like a hack).
    *
-   * @param mixed $input
+   * @param string $input
    *
    * @return bool
    */
@@ -5457,7 +5457,7 @@ 
    * @link http://php.net/manual/en/function.mb-strrpos.php
    *
    * @param string     $haystack  <p>The string being checked, for the last occurrence of needle</p>
-   * @param string|int $needle    <p>The string to find in haystack.<br />Or a code point as int.</p>
+   * @param string $needle    <p>The string to find in haystack.<br />Or a code point as int.</p>
    * @param int        $offset    [optional] <p>May be specified to begin searching an arbitrary number of characters
    *                              into the string. Negative values will stop searching at an arbitrary point prior to
    *                              the end of the string.
@@ -6116,8 +6116,8 @@ 
    *
    * source: https://gist.github.com/stemar/8287074
    *
-   * @param string|string[] $str              <p>The input string or an array of stings.</p>
-   * @param string|string[] $replacement      <p>The replacement string or an array of stings.</p>
+   * @param string $str              <p>The input string or an array of stings.</p>
+   * @param string $replacement      <p>The replacement string or an array of stings.</p>
    * @param int|int[]       $start            <p>
    *                                          If start is positive, the replacing will begin at the start'th offset
    *                                          into string.
@@ -6125,7 +6125,7 @@ 
    *                                          If start is negative, the replacing will begin at the start'th character
    *                                          from the end of string.
    *                                          </p>
-   * @param int|int[]|void  $length           [optional] <p>If given and is positive, it represents the length of the
+   * @param integer  $length           [optional] <p>If given and is positive, it represents the length of the
    *                                          portion of string which is to be replaced. If it is negative, it
    *                                          represents the number of characters from the end of string at which to
    *                                          stop replacing. If it is not given, then it will default to strlen(
@@ -6557,7 +6557,7 @@ 
    * case.</li>
    * </ul>
    *
-   * @param string|string[] $str                    <p>Any string or array.</p>
+   * @param string $str                    <p>Any string or array.</p>
    * @param bool            $decodeHtmlEntityToUtf8 <p>Set to true, if you need to decode html-entities.</p>
    *
    * @return string|string[] <p>The UTF-8 encoded string.</p>

Spacing +67 added lines, -67 removed lines

@@ -851,7 +851,7 @@ 
   public static function add_bom_to_string($str)
   {
     if (self::string_has_bom($str) === false) {
-      $str = self::bom() . $str;
+      $str = self::bom().$str;
     }
 
     return $str;
@@ -957,7 +957,7 @@ 
 
     // use static cache, if there is no support for "\IntlChar"
     static $CHAR_CACHE = array();
-    $cacheKey = $code_point . $encoding;
+    $cacheKey = $code_point.$encoding;
     if (isset($CHAR_CACHE[$cacheKey]) === true) {
       return $CHAR_CACHE[$cacheKey];
     }
@@ -965,16 +965,16 @@ 
     if (0x80 > $code_point %= 0x200000) {
       $str = chr($code_point);
     } elseif (0x800 > $code_point) {
-      $str = chr(0xC0 | $code_point >> 6) .
+      $str = chr(0xC0 | $code_point >> 6).
              chr(0x80 | $code_point & 0x3F);
     } elseif (0x10000 > $code_point) {
-      $str = chr(0xE0 | $code_point >> 12) .
-             chr(0x80 | $code_point >> 6 & 0x3F) .
+      $str = chr(0xE0 | $code_point >> 12).
+             chr(0x80 | $code_point >> 6 & 0x3F).
              chr(0x80 | $code_point & 0x3F);
     } else {
-      $str = chr(0xF0 | $code_point >> 18) .
-             chr(0x80 | $code_point >> 12 & 0x3F) .
-             chr(0x80 | $code_point >> 6 & 0x3F) .
+      $str = chr(0xF0 | $code_point >> 18).
+             chr(0x80 | $code_point >> 12 & 0x3F).
+             chr(0x80 | $code_point >> 6 & 0x3F).
              chr(0x80 | $code_point & 0x3F);
     }
 
@@ -1255,7 +1255,7 @@ 
       $flags = ENT_QUOTES;
     }
 
-    return self::html_entity_decode('&#' . $int . ';', $flags);
+    return self::html_entity_decode('&#'.$int.';', $flags);
   }
 
   /**
@@ -1332,7 +1332,7 @@ 
           &&
           self::$SUPPORT['mbstring'] === false
       ) {
-        trigger_error('UTF8::encode() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+        trigger_error('UTF8::encode() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
       }
 
       $strEncoded = \mb_convert_encoding(
@@ -1531,7 +1531,7 @@ 
           ) {
             // Prevent leading combining chars
             // for NFC-safe concatenations.
-            $var = $leading_combining . $var;
+            $var = $leading_combining.$var;
           }
         }
 
@@ -1952,7 +1952,7 @@ 
    */
   private static function getData($file)
   {
-    $file = __DIR__ . '/data/' . $file . '.php';
+    $file = __DIR__.'/data/'.$file.'.php';
     if (file_exists($file)) {
       /** @noinspection PhpIncludeInspection */
       return require $file;
@@ -2069,7 +2069,7 @@ 
     return implode(
         '',
         array_map(
-            function ($data) use ($keepAsciiChars, $encoding) {
+            function($data) use ($keepAsciiChars, $encoding) {
               return UTF8::single_chr_html_encode($data, $keepAsciiChars, $encoding);
             },
             self::split($str)
@@ -2188,7 +2188,7 @@ 
 
       $str = preg_replace_callback(
           "/&#\d{2,6};/",
-          function ($matches) use ($encoding) {
+          function($matches) use ($encoding) {
             $returnTmp = \mb_convert_encoding($matches[0], $encoding, 'HTML-ENTITIES');
 
             if ($returnTmp !== '"' && $returnTmp !== "'") {
@@ -2512,9 +2512,9 @@ 
     if (ctype_digit((string)$int)) {
       $hex = dechex((int)$int);
 
-      $hex = (strlen($hex) < 4 ? substr('0000' . $hex, -4) : $hex);
+      $hex = (strlen($hex) < 4 ? substr('0000'.$hex, -4) : $hex);
 
-      return $pfix . $hex;
+      return $pfix.$hex;
     }
 
     return '';
@@ -3224,7 +3224,7 @@ 
    */
   public static function lcfirst($str)
   {
-    return self::strtolower(self::substr($str, 0, 1)) . self::substr($str, 1);
+    return self::strtolower(self::substr($str, 0, 1)).self::substr($str, 1);
   }
 
   /**
@@ -3248,7 +3248,7 @@ 
       return preg_replace('/^[\pZ\pC]+/u', '', $str);
     }
 
-    return preg_replace('/^' . self::rxClass($chars) . '+/u', '', $str);
+    return preg_replace('/^'.self::rxClass($chars).'+/u', '', $str);
   }
 
   /**
@@ -3751,7 +3751,7 @@ 
     if (is_array($what)) {
       /** @noinspection ForeachSourceInspection */
       foreach ($what as $item) {
-        $str = preg_replace('/(' . preg_quote($item, '/') . ')+/', $item, $str);
+        $str = preg_replace('/('.preg_quote($item, '/').')+/', $item, $str);
       }
     }
 
@@ -3864,7 +3864,7 @@ 
       return preg_replace('/[\pZ\pC]+$/u', '', $str);
     }
 
-    return preg_replace('/' . self::rxClass($chars) . '+$/u', '', $str);
+    return preg_replace('/'.self::rxClass($chars).'+$/u', '', $str);
   }
 
   /**
@@ -3879,7 +3879,7 @@ 
   {
     static $RX_CLASSS_CACHE = array();
 
-    $cacheKey = $s . $class;
+    $cacheKey = $s.$class;
 
     if (isset($RX_CLASSS_CACHE[$cacheKey])) {
       return $RX_CLASSS_CACHE[$cacheKey];
@@ -3891,7 +3891,7 @@ 
     /** @noinspection SuspiciousLoopInspection */
     foreach (self::str_split($s) as $s) {
       if ('-' === $s) {
-        $class[0] = '-' . $class[0];
+        $class[0] = '-'.$class[0];
       } elseif (!isset($s[2])) {
         $class[0] .= preg_quote($s, '/');
       } elseif (1 === self::strlen($s)) {
@@ -3902,13 +3902,13 @@ 
     }
 
     if ($class[0]) {
-      $class[0] = '[' . $class[0] . ']';
+      $class[0] = '['.$class[0].']';
     }
 
     if (1 === count($class)) {
       $return = $class[0];
     } else {
-      $return = '(?:' . implode('|', $class) . ')';
+      $return = '(?:'.implode('|', $class).')';
     }
 
     $RX_CLASSS_CACHE[$cacheKey] = $return;
@@ -3926,7 +3926,7 @@ 
     }
 
     foreach (self::$SUPPORT as $utf8Support) {
-      echo $utf8Support . "\n<br>";
+      echo $utf8Support."\n<br>";
     }
   }
 
@@ -3960,7 +3960,7 @@ 
       $encoding = self::normalize_encoding($encoding);
     }
 
-    return '&#' . self::ord($char, $encoding) . ';';
+    return '&#'.self::ord($char, $encoding).';';
   }
 
   /**
@@ -4012,19 +4012,19 @@ 
           $ret[] = $str[$i];
         } elseif ((($str[$i] & "\xE0") === "\xC0") && isset($str[$i + 1])) {
           if (($str[$i + 1] & "\xC0") === "\x80") {
-            $ret[] = $str[$i] . $str[$i + 1];
+            $ret[] = $str[$i].$str[$i + 1];
 
             $i++;
           }
         } elseif ((($str[$i] & "\xF0") === "\xE0") && isset($str[$i + 2])) {
           if ((($str[$i + 1] & "\xC0") === "\x80") && (($str[$i + 2] & "\xC0") === "\x80")) {
-            $ret[] = $str[$i] . $str[$i + 1] . $str[$i + 2];
+            $ret[] = $str[$i].$str[$i + 1].$str[$i + 2];
 
             $i += 2;
           }
         } elseif ((($str[$i] & "\xF8") === "\xF0") && isset($str[$i + 3])) {
           if ((($str[$i + 1] & "\xC0") === "\x80") && (($str[$i + 2] & "\xC0") === "\x80") && (($str[$i + 3] & "\xC0") === "\x80")) {
-            $ret[] = $str[$i] . $str[$i + 1] . $str[$i + 2] . $str[$i + 3];
+            $ret[] = $str[$i].$str[$i + 1].$str[$i + 2].$str[$i + 3];
 
             $i += 3;
           }
@@ -4036,7 +4036,7 @@ 
       $ret = array_chunk($ret, $length);
 
       return array_map(
-          function ($item) {
+          function($item) {
             return implode('', $item);
           }, $ret
       );
@@ -4135,7 +4135,7 @@ 
     foreach (self::$ICONV_ENCODING as $encodingTmp) {
       # INFO: //IGNORE and //TRANSLIT still throw notice
       /** @noinspection PhpUsageOfSilenceOperatorInspection */
-      if (md5(@\iconv($encodingTmp, $encodingTmp . '//IGNORE', $str)) === $md5) {
+      if (md5(@\iconv($encodingTmp, $encodingTmp.'//IGNORE', $str)) === $md5) {
         return $encodingTmp;
       }
     }
@@ -4225,7 +4225,7 @@ 
       if ('' === $s .= '') {
         $s = '/^(?<=.)$/';
       } else {
-        $s = '/' . preg_quote($s, '/') . '/ui';
+        $s = '/'.preg_quote($s, '/').'/ui';
       }
     }
 
@@ -4283,7 +4283,7 @@ 
     }
 
     if (self::substr($str, $length - 1, 1) === ' ') {
-      return self::substr($str, 0, $length - 1) . $strAddOn;
+      return self::substr($str, 0, $length - 1).$strAddOn;
     }
 
     $str = self::substr($str, 0, $length);
@@ -4292,9 +4292,9 @@ 
     $new_str = implode(' ', $array);
 
     if ($new_str === '') {
-      $str = self::substr($str, 0, $length - 1) . $strAddOn;
+      $str = self::substr($str, 0, $length - 1).$strAddOn;
     } else {
-      $str = $new_str . $strAddOn;
+      $str = $new_str.$strAddOn;
     }
 
     return $str;
@@ -4349,7 +4349,7 @@ 
           $pre = '';
       }
 
-      return $pre . $str . $post;
+      return $pre.$str.$post;
     }
 
     return $str;
@@ -4499,7 +4499,7 @@ 
     }
 
     /** @noinspection PhpInternalEntityUsedInspection */
-    preg_match_all('/' . Grapheme::GRAPHEME_CLUSTER_RX . '/u', $str, $a);
+    preg_match_all('/'.Grapheme::GRAPHEME_CLUSTER_RX.'/u', $str, $a);
     $a = $a[0];
 
     if ($len === 1) {
@@ -4694,7 +4694,7 @@ 
   public static function strcmp($str1, $str2)
   {
     /** @noinspection PhpUndefinedClassInspection */
-    return $str1 . '' === $str2 . '' ? 0 : strcmp(
+    return $str1.'' === $str2.'' ? 0 : strcmp(
         \Normalizer::normalize($str1, \Normalizer::NFD),
         \Normalizer::normalize($str2, \Normalizer::NFD)
     );
@@ -4725,7 +4725,7 @@ 
       return null;
     }
 
-    if (preg_match('/^(.*?)' . self::rxClass($charList) . '/us', $str, $length)) {
+    if (preg_match('/^(.*?)'.self::rxClass($charList).'/us', $str, $length)) {
       /** @noinspection OffsetOperationsInspection */
       return self::strlen($length[1]);
     }
@@ -4932,7 +4932,7 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::stristr() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::stristr() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (self::$SUPPORT['mbstring'] === true) {
@@ -4943,7 +4943,7 @@ 
       return \grapheme_stristr($haystack, $needle, $before_needle);
     }
 
-    preg_match('/^(.*?)' . preg_quote($needle, '/') . '/usi', $haystack, $match);
+    preg_match('/^(.*?)'.preg_quote($needle, '/').'/usi', $haystack, $match);
 
     if (!isset($match[1])) {
       return false;
@@ -5007,7 +5007,7 @@ 
         &&
         self::$SUPPORT['iconv'] === false
     ) {
-      trigger_error('UTF8::strlen() without mbstring / iconv cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::strlen() without mbstring / iconv cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (
@@ -5086,7 +5086,7 @@ 
    */
   public static function strnatcmp($str1, $str2)
   {
-    return $str1 . '' === $str2 . '' ? 0 : strnatcmp(self::strtonatfold($str1), self::strtonatfold($str2));
+    return $str1.'' === $str2.'' ? 0 : strnatcmp(self::strtonatfold($str1), self::strtonatfold($str2));
   }
 
   /**
@@ -5147,7 +5147,7 @@ 
       return false;
     }
 
-    if (preg_match('/' . self::rxClass($char_list) . '/us', $haystack, $m)) {
+    if (preg_match('/'.self::rxClass($char_list).'/us', $haystack, $m)) {
       return substr($haystack, strpos($haystack, $m[0]));
     } else {
       return false;
@@ -5216,7 +5216,7 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::strpos() without mbstring / iconv cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::strpos() without mbstring / iconv cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (
@@ -5432,7 +5432,7 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::strripos() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::strripos() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (self::$SUPPORT['mbstring'] === true) {
@@ -5512,7 +5512,7 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::strrpos() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::strrpos() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (self::$SUPPORT['mbstring'] === true) {
@@ -5572,7 +5572,7 @@ 
       return 0;
     }
 
-    return preg_match('/^' . self::rxClass($mask) . '+/u', $str, $str) ? self::strlen($str[0]) : 0;
+    return preg_match('/^'.self::rxClass($mask).'+/u', $str, $str) ? self::strlen($str[0]) : 0;
   }
 
   /**
@@ -5618,7 +5618,7 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::strstr() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::strstr() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (self::$SUPPORT['mbstring'] === true) {
@@ -5635,7 +5635,7 @@ 
       }
     }
 
-    preg_match('/^(.*?)' . preg_quote($needle, '/') . '/us', $haystack, $match);
+    preg_match('/^(.*?)'.preg_quote($needle, '/').'/us', $haystack, $match);
 
     if (!isset($match[1])) {
       return false;
@@ -5899,7 +5899,7 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::substr() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::substr() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (self::$SUPPORT['mbstring'] === true) {
@@ -6012,14 +6012,14 @@ 
         &&
         self::$SUPPORT['mbstring'] === false
     ) {
-      trigger_error('UTF8::substr_count() without mbstring cannot handle "' . $encoding . '" encoding', E_USER_WARNING);
+      trigger_error('UTF8::substr_count() without mbstring cannot handle "'.$encoding.'" encoding', E_USER_WARNING);
     }
 
     if (self::$SUPPORT['mbstring'] === true) {
       return \mb_substr_count($haystack, $needle, $encoding);
     }
 
-    preg_match_all('/' . preg_quote($needle, '/') . '/us', $haystack, $matches, PREG_SET_ORDER);
+    preg_match_all('/'.preg_quote($needle, '/').'/us', $haystack, $matches, PREG_SET_ORDER);
 
     return count($matches);
   }
@@ -6266,7 +6266,7 @@ 
 
     $strSwappedCase = preg_replace_callback(
         '/[\S]/u',
-        function ($match) use ($encoding) {
+        function($match) use ($encoding) {
           $marchToUpper = UTF8::strtoupper($match[0], $encoding);
 
           if ($match[0] === $marchToUpper) {
@@ -6596,40 +6596,40 @@ 
         if ($c1 >= "\xc0" & $c1 <= "\xdf") { // looks like 2 bytes UTF8
 
           if ($c2 >= "\x80" && $c2 <= "\xbf") { // yeah, almost sure it's UTF8 already
-            $buf .= $c1 . $c2;
+            $buf .= $c1.$c2;
             $i++;
           } else { // not valid UTF8 - convert it
             $cc1 = (chr(ord($c1) / 64) | "\xc0");
             $cc2 = ($c1 & "\x3f") | "\x80";
-            $buf .= $cc1 . $cc2;
+            $buf .= $cc1.$cc2;
           }
 
         } elseif ($c1 >= "\xe0" & $c1 <= "\xef") { // looks like 3 bytes UTF8
 
           if ($c2 >= "\x80" && $c2 <= "\xbf" && $c3 >= "\x80" && $c3 <= "\xbf") { // yeah, almost sure it's UTF8 already
-            $buf .= $c1 . $c2 . $c3;
+            $buf .= $c1.$c2.$c3;
             $i += 2;
           } else { // not valid UTF8 - convert it
             $cc1 = (chr(ord($c1) / 64) | "\xc0");
             $cc2 = ($c1 & "\x3f") | "\x80";
-            $buf .= $cc1 . $cc2;
+            $buf .= $cc1.$cc2;
           }
 
         } elseif ($c1 >= "\xf0" & $c1 <= "\xf7") { // looks like 4 bytes UTF8
 
           if ($c2 >= "\x80" && $c2 <= "\xbf" && $c3 >= "\x80" && $c3 <= "\xbf" && $c4 >= "\x80" && $c4 <= "\xbf") { // yeah, almost sure it's UTF8 already
-            $buf .= $c1 . $c2 . $c3 . $c4;
+            $buf .= $c1.$c2.$c3.$c4;
             $i += 3;
           } else { // not valid UTF8 - convert it
             $cc1 = (chr(ord($c1) / 64) | "\xc0");
             $cc2 = ($c1 & "\x3f") | "\x80";
-            $buf .= $cc1 . $cc2;
+            $buf .= $cc1.$cc2;
           }
 
         } else { // doesn't look like UTF8, but should be converted
           $cc1 = (chr(ord($c1) / 64) | "\xc0");
           $cc2 = (($c1 & "\x3f") | "\x80");
-          $buf .= $cc1 . $cc2;
+          $buf .= $cc1.$cc2;
         }
 
       } elseif (($c1 & "\xc0") === "\x80") { // needs conversion
@@ -6640,7 +6640,7 @@ 
         } else {
           $cc1 = (chr($ordC1 / 64) | "\xc0");
           $cc2 = (($c1 & "\x3f") | "\x80");
-          $buf .= $cc1 . $cc2;
+          $buf .= $cc1.$cc2;
         }
 
       } else { // it doesn't need conversion
@@ -6651,7 +6651,7 @@ 
     // decode unicode escape sequences
     $buf = preg_replace_callback(
         '/\\\\u([0-9a-f]{4})/i',
-        function ($match) {
+        function($match) {
           return \mb_convert_encoding(pack('H*', $match[1]), 'UTF-8', 'UCS-2BE');
         },
         $buf
@@ -6705,7 +6705,7 @@ 
    */
   public static function ucfirst($str, $encoding = 'UTF-8', $cleanUtf8 = false)
   {
-    return self::strtoupper(self::substr($str, 0, 1, $encoding, $cleanUtf8), $encoding, $cleanUtf8) . self::substr($str, 1, null, $encoding, $cleanUtf8);
+    return self::strtoupper(self::substr($str, 0, 1, $encoding, $cleanUtf8), $encoding, $cleanUtf8).self::substr($str, 1, null, $encoding, $cleanUtf8);
   }
 
   /**
@@ -7180,7 +7180,7 @@ 
       return '';
     }
 
-    preg_match('/^\s*+(?:\S++\s*+){1,' . $words . '}/u', $str, $matches);
+    preg_match('/^\s*+(?:\S++\s*+){1,'.$words.'}/u', $str, $matches);
 
     if (
         !isset($matches[0])
@@ -7190,7 +7190,7 @@ 
       return $str;
     }
 
-    return self::rtrim($matches[0]) . $strAddOn;
+    return self::rtrim($matches[0]).$strAddOn;
   }
 
   /**
@@ -7258,7 +7258,7 @@ 
       $strReturn .= $break;
     }
 
-    return $strReturn . implode('', $chars);
+    return $strReturn.implode('', $chars);
   }
 
   /**