voku / portable-utf8

src/voku/helper/UTF8.php

Doc Comments +4 added lines, -4 removed lines

@@ -3409,7 +3409,7 @@ 
   /**
    * Check if the input is binary... (is look like a hack).
    *
-   * @param mixed $input
+   * @param string $input
    *
    * @return bool
    */
@@ -5624,7 +5624,7 @@ 
    *                              The string being checked, for the last occurrence
    *                              of needle
    *                              </p>
-   * @param string|int $needle    <p>
+   * @param string $needle    <p>
    *                              The string to find in haystack.
    *                              Or a code point as int.
    *                              </p>
@@ -5700,7 +5700,7 @@ 
    * @param int    $offset
    * @param int    $length
    *
-   * @return int|null
+   * @return integer
    */
   public static function strspn($str, $mask, $offset = 0, $length = 2147483647)
   {
@@ -6324,7 +6324,7 @@ 
    * 2) when any of these: àáâãäåæçèéêëìíîï  are followed by TWO chars from group B,
    * 3) when any of these: ðñòó  are followed by THREE chars from group B.
    *
-   * @param string|array $str Any string or array.
+   * @param string $str Any string or array.
    *
    * @return string The same string, but UTF8 encoded.
    */

Spacing +45 added lines, -45 removed lines

@@ -834,7 +834,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;
@@ -2154,7 +2154,7 @@ 
     self::checkForSupport();
 
     return \mb_convert_encoding(
-        '&#x' . dechex($code) . ';',
+        '&#x'.dechex($code).';',
         'UTF-8',
         'HTML-ENTITIES'
     );
@@ -2434,7 +2434,7 @@ 
           if ($var[0] >= "\x80" && isset($n[0], $leading_combining[0]) && preg_match('/^\p{Mn}/u', $var)) {
             // Prevent leading combining chars
             // for NFC-safe concatenations.
-            $var = $leading_combining . $var;
+            $var = $leading_combining.$var;
           }
         }
         break;
@@ -2721,7 +2721,7 @@ 
    */
   protected static function getData($file)
   {
-    $file = __DIR__ . '/data/' . $file . '.php';
+    $file = __DIR__.'/data/'.$file.'.php';
     if (file_exists($file)) {
       /** @noinspection PhpIncludeInspection */
       return require $file;
@@ -2846,7 +2846,7 @@ 
 
     return implode(
         array_map(
-            function ($data) use ($keepAsciiChars) {
+            function($data) use ($keepAsciiChars) {
               return UTF8::single_chr_html_encode($data, $keepAsciiChars);
             },
             self::split($str)
@@ -3235,9 +3235,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 '';
@@ -3875,7 +3875,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);
   }
 
   /**
@@ -4281,7 +4281,7 @@ 
 
     if (is_array($what)) {
       foreach ($what as $item) {
-        $str = preg_replace('/(' . preg_quote($item, '/') . ')+/', $item, $str);
+        $str = preg_replace('/('.preg_quote($item, '/').')+/', $item, $str);
       }
     }
 
@@ -4381,7 +4381,7 @@ 
   {
     static $rxClassCache = array();
 
-    $cacheKey = $s . $class;
+    $cacheKey = $s.$class;
 
     if (isset($rxClassCache[$cacheKey])) {
       return $rxClassCache[$cacheKey];
@@ -4392,7 +4392,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)) {
@@ -4402,12 +4402,12 @@ 
       }
     }
 
-    $class[0] = '[' . $class[0] . ']';
+    $class[0] = '['.$class[0].']';
 
     if (1 === count($class)) {
       $return = $class[0];
     } else {
-      $return = '(?:' . implode('|', $class) . ')';
+      $return = '(?:'.implode('|', $class).')';
     }
 
     $rxClassCache[$cacheKey] = $return;
@@ -4421,7 +4421,7 @@ 
   public static function showSupport()
   {
     foreach (self::$support as $utf8Support) {
-      echo $utf8Support . "\n<br>";
+      echo $utf8Support."\n<br>";
     }
   }
 
@@ -4447,7 +4447,7 @@ 
       return $char;
     }
 
-    return '&#' . self::ord($char) . ';';
+    return '&#'.self::ord($char).';';
   }
 
   /**
@@ -4496,19 +4496,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;
           }
@@ -4642,7 +4642,7 @@ 
       if ('' === $s .= '') {
         $s = '/^(?<=.)$/';
       } else {
-        $s = '/' . preg_quote($s, '/') . '/ui';
+        $s = '/'.preg_quote($s, '/').'/ui';
       }
     }
 
@@ -4676,7 +4676,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);
@@ -4685,9 +4685,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;
@@ -4733,7 +4733,7 @@ 
           $pre = '';
       }
 
-      return $pre . $str . $post;
+      return $pre.$str.$post;
     }
 
     return $str;
@@ -4867,7 +4867,7 @@ 
         $a[] = \grapheme_extract($str, 1, GRAPHEME_EXTR_COUNT, $p, $p);
       }
     } else {
-      preg_match_all('/' . Grapheme::GRAPHEME_CLUSTER_RX . '/u', $str, $a);
+      preg_match_all('/'.Grapheme::GRAPHEME_CLUSTER_RX.'/u', $str, $a);
       $a = $a[0];
     }
 
@@ -5008,7 +5008,7 @@ 
 
       $bank = $ord >> 8;
       if (!array_key_exists($bank, (array)$UTF8_TO_ASCII)) {
-        $bankfile = __DIR__ . '/data/' . sprintf('x%02x', $bank) . '.php';
+        $bankfile = __DIR__.'/data/'.sprintf('x%02x', $bank).'.php';
         if (file_exists($bankfile)) {
           /** @noinspection PhpIncludeInspection */
           require $bankfile;
@@ -5098,7 +5098,7 @@ 
    */
   public static function strcmp($str1, $str2)
   {
-    return $str1 . '' === $str2 . '' ? 0 : strcmp(
+    return $str1.'' === $str2.'' ? 0 : strcmp(
         \Normalizer::normalize($str1, \Normalizer::NFD),
         \Normalizer::normalize($str2, \Normalizer::NFD)
     );
@@ -5126,7 +5126,7 @@ 
       $str = (string)$str;
     }
 
-    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]);
     } else {
@@ -5350,7 +5350,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));
   }
 
   /**
@@ -5431,7 +5431,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;
@@ -5708,7 +5708,7 @@ 
       $str = self::substr($str, $offset, $length);
     }
 
-    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;
   }
 
   /**
@@ -6151,7 +6151,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) {
@@ -6360,40 +6360,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
@@ -6404,7 +6404,7 @@ 
         } else {
           $cc1 = (chr($ordC1 / 64) | "\xc0");
           $cc2 = (($c1 & "\x3f") | "\x80");
-          $buf .= $cc1 . $cc2;
+          $buf .= $cc1.$cc2;
         }
 
       } else { // it doesn't need conversion
@@ -6417,7 +6417,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
@@ -6426,7 +6426,7 @@ 
     // decode UTF-8 codepoints
     $buf = preg_replace_callback(
         '/&#\d{2,4};/',
-        function ($match) {
+        function($match) {
           return \mb_convert_encoding($match[0], 'UTF-8', 'HTML-ENTITIES');
         },
         $buf
@@ -6501,7 +6501,7 @@ 
    */
   public static function ucfirst($str)
   {
-    return self::strtoupper(self::substr($str, 0, 1)) . self::substr($str, 1);
+    return self::strtoupper(self::substr($str, 0, 1)).self::substr($str, 1);
   }
 
   /**
@@ -6950,7 +6950,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])
@@ -6960,7 +6960,7 @@ 
       return $str;
     }
 
-    return self::rtrim($matches[0]) . $strAddOn;
+    return self::rtrim($matches[0]).$strAddOn;
   }
 
   /**
@@ -7042,7 +7042,7 @@ 
       $strReturn .= $break;
     }
 
-    return $strReturn . implode('', $chars);
+    return $strReturn.implode('', $chars);
   }
 
   /**