annotate vendor/symfony/polyfill-mbstring/Mbstring.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 129ea1e6d783
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /*
Chris@0 4 * This file is part of the Symfony package.
Chris@0 5 *
Chris@0 6 * (c) Fabien Potencier <fabien@symfony.com>
Chris@0 7 *
Chris@0 8 * For the full copyright and license information, please view the LICENSE
Chris@0 9 * file that was distributed with this source code.
Chris@0 10 */
Chris@0 11
Chris@0 12 namespace Symfony\Polyfill\Mbstring;
Chris@0 13
Chris@0 14 /**
Chris@0 15 * Partial mbstring implementation in PHP, iconv based, UTF-8 centric.
Chris@0 16 *
Chris@0 17 * Implemented:
Chris@0 18 * - mb_chr - Returns a specific character from its Unicode code point
Chris@0 19 * - mb_convert_encoding - Convert character encoding
Chris@0 20 * - mb_convert_variables - Convert character code in variable(s)
Chris@0 21 * - mb_decode_mimeheader - Decode string in MIME header field
Chris@0 22 * - mb_encode_mimeheader - Encode string for MIME header XXX NATIVE IMPLEMENTATION IS REALLY BUGGED
Chris@12 23 * - mb_decode_numericentity - Decode HTML numeric string reference to character
Chris@12 24 * - mb_encode_numericentity - Encode character to HTML numeric string reference
Chris@0 25 * - mb_convert_case - Perform case folding on a string
Chris@12 26 * - mb_detect_encoding - Detect character encoding
Chris@0 27 * - mb_get_info - Get internal settings of mbstring
Chris@0 28 * - mb_http_input - Detect HTTP input character encoding
Chris@0 29 * - mb_http_output - Set/Get HTTP output character encoding
Chris@0 30 * - mb_internal_encoding - Set/Get internal character encoding
Chris@0 31 * - mb_list_encodings - Returns an array of all supported encodings
Chris@0 32 * - mb_ord - Returns the Unicode code point of a character
Chris@0 33 * - mb_output_handler - Callback function converts character encoding in output buffer
Chris@0 34 * - mb_scrub - Replaces ill-formed byte sequences with substitute characters
Chris@0 35 * - mb_strlen - Get string length
Chris@0 36 * - mb_strpos - Find position of first occurrence of string in a string
Chris@0 37 * - mb_strrpos - Find position of last occurrence of a string in a string
Chris@0 38 * - mb_strtolower - Make a string lowercase
Chris@0 39 * - mb_strtoupper - Make a string uppercase
Chris@0 40 * - mb_substitute_character - Set/Get substitution character
Chris@0 41 * - mb_substr - Get part of string
Chris@0 42 * - mb_stripos - Finds position of first occurrence of a string within another, case insensitive
Chris@0 43 * - mb_stristr - Finds first occurrence of a string within another, case insensitive
Chris@0 44 * - mb_strrchr - Finds the last occurrence of a character in a string within another
Chris@0 45 * - mb_strrichr - Finds the last occurrence of a character in a string within another, case insensitive
Chris@0 46 * - mb_strripos - Finds position of last occurrence of a string within another, case insensitive
Chris@17 47 * - mb_strstr - Finds first occurrence of a string within another
Chris@0 48 * - mb_strwidth - Return width of string
Chris@0 49 * - mb_substr_count - Count the number of substring occurrences
Chris@0 50 *
Chris@0 51 * Not implemented:
Chris@0 52 * - mb_convert_kana - Convert "kana" one from another ("zen-kaku", "han-kaku" and more)
Chris@0 53 * - mb_ereg_* - Regular expression with multibyte support
Chris@0 54 * - mb_parse_str - Parse GET/POST/COOKIE data and set global variable
Chris@0 55 * - mb_preferred_mime_name - Get MIME charset string
Chris@0 56 * - mb_regex_encoding - Returns current encoding for multibyte regex as string
Chris@0 57 * - mb_regex_set_options - Set/Get the default options for mbregex functions
Chris@0 58 * - mb_send_mail - Send encoded mail
Chris@0 59 * - mb_split - Split multibyte string using regular expression
Chris@0 60 * - mb_strcut - Get part of string
Chris@0 61 * - mb_strimwidth - Get truncated string with specified width
Chris@0 62 *
Chris@0 63 * @author Nicolas Grekas <p@tchwork.com>
Chris@0 64 *
Chris@0 65 * @internal
Chris@0 66 */
Chris@0 67 final class Mbstring
Chris@0 68 {
Chris@0 69 const MB_CASE_FOLD = PHP_INT_MAX;
Chris@0 70
Chris@0 71 private static $encodingList = array('ASCII', 'UTF-8');
Chris@0 72 private static $language = 'neutral';
Chris@0 73 private static $internalEncoding = 'UTF-8';
Chris@0 74 private static $caseFold = array(
Chris@17 75 array('µ', 'ſ', "\xCD\x85", 'ς', "\xCF\x90", "\xCF\x91", "\xCF\x95", "\xCF\x96", "\xCF\xB0", "\xCF\xB1", "\xCF\xB5", "\xE1\xBA\x9B", "\xE1\xBE\xBE"),
Chris@17 76 array('μ', 's', 'ι', 'σ', 'β', 'θ', 'φ', 'π', 'κ', 'ρ', 'ε', "\xE1\xB9\xA1", 'ι'),
Chris@0 77 );
Chris@0 78
Chris@0 79 public static function mb_convert_encoding($s, $toEncoding, $fromEncoding = null)
Chris@0 80 {
Chris@16 81 if (\is_array($fromEncoding) || false !== strpos($fromEncoding, ',')) {
Chris@0 82 $fromEncoding = self::mb_detect_encoding($s, $fromEncoding);
Chris@0 83 } else {
Chris@0 84 $fromEncoding = self::getEncoding($fromEncoding);
Chris@0 85 }
Chris@0 86
Chris@0 87 $toEncoding = self::getEncoding($toEncoding);
Chris@0 88
Chris@0 89 if ('BASE64' === $fromEncoding) {
Chris@0 90 $s = base64_decode($s);
Chris@0 91 $fromEncoding = $toEncoding;
Chris@0 92 }
Chris@0 93
Chris@0 94 if ('BASE64' === $toEncoding) {
Chris@0 95 return base64_encode($s);
Chris@0 96 }
Chris@0 97
Chris@0 98 if ('HTML-ENTITIES' === $toEncoding || 'HTML' === $toEncoding) {
Chris@0 99 if ('HTML-ENTITIES' === $fromEncoding || 'HTML' === $fromEncoding) {
Chris@0 100 $fromEncoding = 'Windows-1252';
Chris@0 101 }
Chris@0 102 if ('UTF-8' !== $fromEncoding) {
Chris@0 103 $s = iconv($fromEncoding, 'UTF-8//IGNORE', $s);
Chris@0 104 }
Chris@0 105
Chris@0 106 return preg_replace_callback('/[\x80-\xFF]+/', array(__CLASS__, 'html_encoding_callback'), $s);
Chris@0 107 }
Chris@0 108
Chris@0 109 if ('HTML-ENTITIES' === $fromEncoding) {
Chris@0 110 $s = html_entity_decode($s, ENT_COMPAT, 'UTF-8');
Chris@0 111 $fromEncoding = 'UTF-8';
Chris@0 112 }
Chris@0 113
Chris@0 114 return iconv($fromEncoding, $toEncoding.'//IGNORE', $s);
Chris@0 115 }
Chris@0 116
Chris@0 117 public static function mb_convert_variables($toEncoding, $fromEncoding, &$a = null, &$b = null, &$c = null, &$d = null, &$e = null, &$f = null)
Chris@0 118 {
Chris@0 119 $vars = array(&$a, &$b, &$c, &$d, &$e, &$f);
Chris@0 120
Chris@0 121 $ok = true;
Chris@0 122 array_walk_recursive($vars, function (&$v) use (&$ok, $toEncoding, $fromEncoding) {
Chris@0 123 if (false === $v = Mbstring::mb_convert_encoding($v, $toEncoding, $fromEncoding)) {
Chris@0 124 $ok = false;
Chris@0 125 }
Chris@0 126 });
Chris@0 127
Chris@0 128 return $ok ? $fromEncoding : false;
Chris@0 129 }
Chris@0 130
Chris@0 131 public static function mb_decode_mimeheader($s)
Chris@0 132 {
Chris@0 133 return iconv_mime_decode($s, 2, self::$internalEncoding);
Chris@0 134 }
Chris@0 135
Chris@0 136 public static function mb_encode_mimeheader($s, $charset = null, $transferEncoding = null, $linefeed = null, $indent = null)
Chris@0 137 {
Chris@0 138 trigger_error('mb_encode_mimeheader() is bugged. Please use iconv_mime_encode() instead', E_USER_WARNING);
Chris@0 139 }
Chris@0 140
Chris@12 141 public static function mb_decode_numericentity($s, $convmap, $encoding = null)
Chris@0 142 {
Chris@16 143 if (null !== $s && !\is_scalar($s) && !(\is_object($s) && \method_exists($s, '__toString'))) {
Chris@17 144 trigger_error('mb_decode_numericentity() expects parameter 1 to be string, '.\gettype($s).' given', E_USER_WARNING);
Chris@17 145
Chris@12 146 return null;
Chris@12 147 }
Chris@12 148
Chris@16 149 if (!\is_array($convmap) || !$convmap) {
Chris@12 150 return false;
Chris@12 151 }
Chris@12 152
Chris@16 153 if (null !== $encoding && !\is_scalar($encoding)) {
Chris@17 154 trigger_error('mb_decode_numericentity() expects parameter 3 to be string, '.\gettype($s).' given', E_USER_WARNING);
Chris@17 155
Chris@12 156 return ''; // Instead of null (cf. mb_encode_numericentity).
Chris@12 157 }
Chris@12 158
Chris@12 159 $s = (string) $s;
Chris@12 160 if ('' === $s) {
Chris@0 161 return '';
Chris@0 162 }
Chris@0 163
Chris@0 164 $encoding = self::getEncoding($encoding);
Chris@0 165
Chris@0 166 if ('UTF-8' === $encoding) {
Chris@0 167 $encoding = null;
Chris@12 168 if (!preg_match('//u', $s)) {
Chris@12 169 $s = @iconv('UTF-8', 'UTF-8//IGNORE', $s);
Chris@12 170 }
Chris@12 171 } else {
Chris@12 172 $s = iconv($encoding, 'UTF-8//IGNORE', $s);
Chris@12 173 }
Chris@12 174
Chris@16 175 $cnt = floor(\count($convmap) / 4) * 4;
Chris@12 176
Chris@12 177 for ($i = 0; $i < $cnt; $i += 4) {
Chris@12 178 // collector_decode_htmlnumericentity ignores $convmap[$i + 3]
Chris@12 179 $convmap[$i] += $convmap[$i + 2];
Chris@12 180 $convmap[$i + 1] += $convmap[$i + 2];
Chris@12 181 }
Chris@12 182
Chris@12 183 $s = preg_replace_callback('/&#(?:0*([0-9]+)|x0*([0-9a-fA-F]+))(?!&);?/', function (array $m) use ($cnt, $convmap) {
Chris@12 184 $c = isset($m[2]) ? (int) hexdec($m[2]) : $m[1];
Chris@12 185 for ($i = 0; $i < $cnt; $i += 4) {
Chris@12 186 if ($c >= $convmap[$i] && $c <= $convmap[$i + 1]) {
Chris@12 187 return Mbstring::mb_chr($c - $convmap[$i + 2]);
Chris@12 188 }
Chris@12 189 }
Chris@17 190
Chris@12 191 return $m[0];
Chris@12 192 }, $s);
Chris@12 193
Chris@12 194 if (null === $encoding) {
Chris@12 195 return $s;
Chris@12 196 }
Chris@12 197
Chris@12 198 return iconv('UTF-8', $encoding.'//IGNORE', $s);
Chris@12 199 }
Chris@12 200
Chris@12 201 public static function mb_encode_numericentity($s, $convmap, $encoding = null, $is_hex = false)
Chris@12 202 {
Chris@16 203 if (null !== $s && !\is_scalar($s) && !(\is_object($s) && \method_exists($s, '__toString'))) {
Chris@17 204 trigger_error('mb_encode_numericentity() expects parameter 1 to be string, '.\gettype($s).' given', E_USER_WARNING);
Chris@17 205
Chris@12 206 return null;
Chris@12 207 }
Chris@12 208
Chris@16 209 if (!\is_array($convmap) || !$convmap) {
Chris@12 210 return false;
Chris@12 211 }
Chris@12 212
Chris@16 213 if (null !== $encoding && !\is_scalar($encoding)) {
Chris@17 214 trigger_error('mb_encode_numericentity() expects parameter 3 to be string, '.\gettype($s).' given', E_USER_WARNING);
Chris@17 215
Chris@12 216 return null; // Instead of '' (cf. mb_decode_numericentity).
Chris@12 217 }
Chris@12 218
Chris@16 219 if (null !== $is_hex && !\is_scalar($is_hex)) {
Chris@17 220 trigger_error('mb_encode_numericentity() expects parameter 4 to be boolean, '.\gettype($s).' given', E_USER_WARNING);
Chris@17 221
Chris@12 222 return null;
Chris@12 223 }
Chris@12 224
Chris@12 225 $s = (string) $s;
Chris@12 226 if ('' === $s) {
Chris@12 227 return '';
Chris@12 228 }
Chris@12 229
Chris@12 230 $encoding = self::getEncoding($encoding);
Chris@12 231
Chris@12 232 if ('UTF-8' === $encoding) {
Chris@12 233 $encoding = null;
Chris@12 234 if (!preg_match('//u', $s)) {
Chris@12 235 $s = @iconv('UTF-8', 'UTF-8//IGNORE', $s);
Chris@12 236 }
Chris@12 237 } else {
Chris@12 238 $s = iconv($encoding, 'UTF-8//IGNORE', $s);
Chris@12 239 }
Chris@12 240
Chris@12 241 static $ulenMask = array("\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4);
Chris@12 242
Chris@16 243 $cnt = floor(\count($convmap) / 4) * 4;
Chris@12 244 $i = 0;
Chris@16 245 $len = \strlen($s);
Chris@12 246 $result = '';
Chris@12 247
Chris@12 248 while ($i < $len) {
Chris@12 249 $ulen = $s[$i] < "\x80" ? 1 : $ulenMask[$s[$i] & "\xF0"];
Chris@12 250 $uchr = substr($s, $i, $ulen);
Chris@12 251 $i += $ulen;
Chris@12 252 $c = self::mb_ord($uchr);
Chris@12 253
Chris@12 254 for ($j = 0; $j < $cnt; $j += 4) {
Chris@12 255 if ($c >= $convmap[$j] && $c <= $convmap[$j + 1]) {
Chris@12 256 $cOffset = ($c + $convmap[$j + 2]) & $convmap[$j + 3];
Chris@12 257 $result .= $is_hex ? sprintf('&#x%X;', $cOffset) : '&#'.$cOffset.';';
Chris@12 258 continue 2;
Chris@12 259 }
Chris@12 260 }
Chris@12 261 $result .= $uchr;
Chris@12 262 }
Chris@12 263
Chris@12 264 if (null === $encoding) {
Chris@12 265 return $result;
Chris@12 266 }
Chris@12 267
Chris@12 268 return iconv('UTF-8', $encoding.'//IGNORE', $result);
Chris@12 269 }
Chris@12 270
Chris@12 271 public static function mb_convert_case($s, $mode, $encoding = null)
Chris@12 272 {
Chris@12 273 $s = (string) $s;
Chris@12 274 if ('' === $s) {
Chris@12 275 return '';
Chris@12 276 }
Chris@12 277
Chris@12 278 $encoding = self::getEncoding($encoding);
Chris@12 279
Chris@12 280 if ('UTF-8' === $encoding) {
Chris@12 281 $encoding = null;
Chris@12 282 if (!preg_match('//u', $s)) {
Chris@12 283 $s = @iconv('UTF-8', 'UTF-8//IGNORE', $s);
Chris@12 284 }
Chris@0 285 } else {
Chris@0 286 $s = iconv($encoding, 'UTF-8//IGNORE', $s);
Chris@0 287 }
Chris@0 288
Chris@0 289 if (MB_CASE_TITLE == $mode) {
Chris@17 290 static $titleRegexp = null;
Chris@17 291 if (null === $titleRegexp) {
Chris@17 292 $titleRegexp = self::getData('titleCaseRegexp');
Chris@17 293 }
Chris@17 294 $s = preg_replace_callback($titleRegexp, array(__CLASS__, 'title_case'), $s);
Chris@0 295 } else {
Chris@0 296 if (MB_CASE_UPPER == $mode) {
Chris@0 297 static $upper = null;
Chris@0 298 if (null === $upper) {
Chris@0 299 $upper = self::getData('upperCase');
Chris@0 300 }
Chris@0 301 $map = $upper;
Chris@0 302 } else {
Chris@0 303 if (self::MB_CASE_FOLD === $mode) {
Chris@0 304 $s = str_replace(self::$caseFold[0], self::$caseFold[1], $s);
Chris@0 305 }
Chris@0 306
Chris@0 307 static $lower = null;
Chris@0 308 if (null === $lower) {
Chris@0 309 $lower = self::getData('lowerCase');
Chris@0 310 }
Chris@0 311 $map = $lower;
Chris@0 312 }
Chris@0 313
Chris@0 314 static $ulenMask = array("\xC0" => 2, "\xD0" => 2, "\xE0" => 3, "\xF0" => 4);
Chris@0 315
Chris@0 316 $i = 0;
Chris@16 317 $len = \strlen($s);
Chris@0 318
Chris@0 319 while ($i < $len) {
Chris@0 320 $ulen = $s[$i] < "\x80" ? 1 : $ulenMask[$s[$i] & "\xF0"];
Chris@0 321 $uchr = substr($s, $i, $ulen);
Chris@0 322 $i += $ulen;
Chris@0 323
Chris@0 324 if (isset($map[$uchr])) {
Chris@0 325 $uchr = $map[$uchr];
Chris@16 326 $nlen = \strlen($uchr);
Chris@0 327
Chris@0 328 if ($nlen == $ulen) {
Chris@0 329 $nlen = $i;
Chris@0 330 do {
Chris@0 331 $s[--$nlen] = $uchr[--$ulen];
Chris@0 332 } while ($ulen);
Chris@0 333 } else {
Chris@0 334 $s = substr_replace($s, $uchr, $i - $ulen, $ulen);
Chris@0 335 $len += $nlen - $ulen;
Chris@17 336 $i += $nlen - $ulen;
Chris@0 337 }
Chris@0 338 }
Chris@0 339 }
Chris@0 340 }
Chris@0 341
Chris@0 342 if (null === $encoding) {
Chris@0 343 return $s;
Chris@0 344 }
Chris@0 345
Chris@0 346 return iconv('UTF-8', $encoding.'//IGNORE', $s);
Chris@0 347 }
Chris@0 348
Chris@0 349 public static function mb_internal_encoding($encoding = null)
Chris@0 350 {
Chris@0 351 if (null === $encoding) {
Chris@0 352 return self::$internalEncoding;
Chris@0 353 }
Chris@0 354
Chris@0 355 $encoding = self::getEncoding($encoding);
Chris@0 356
Chris@0 357 if ('UTF-8' === $encoding || false !== @iconv($encoding, $encoding, ' ')) {
Chris@0 358 self::$internalEncoding = $encoding;
Chris@0 359
Chris@0 360 return true;
Chris@0 361 }
Chris@0 362
Chris@0 363 return false;
Chris@0 364 }
Chris@0 365
Chris@0 366 public static function mb_language($lang = null)
Chris@0 367 {
Chris@0 368 if (null === $lang) {
Chris@0 369 return self::$language;
Chris@0 370 }
Chris@0 371
Chris@0 372 switch ($lang = strtolower($lang)) {
Chris@0 373 case 'uni':
Chris@0 374 case 'neutral':
Chris@0 375 self::$language = $lang;
Chris@0 376
Chris@0 377 return true;
Chris@0 378 }
Chris@0 379
Chris@0 380 return false;
Chris@0 381 }
Chris@0 382
Chris@0 383 public static function mb_list_encodings()
Chris@0 384 {
Chris@0 385 return array('UTF-8');
Chris@0 386 }
Chris@0 387
Chris@0 388 public static function mb_encoding_aliases($encoding)
Chris@0 389 {
Chris@0 390 switch (strtoupper($encoding)) {
Chris@0 391 case 'UTF8':
Chris@0 392 case 'UTF-8':
Chris@0 393 return array('utf8');
Chris@0 394 }
Chris@0 395
Chris@0 396 return false;
Chris@0 397 }
Chris@0 398
Chris@0 399 public static function mb_check_encoding($var = null, $encoding = null)
Chris@0 400 {
Chris@0 401 if (null === $encoding) {
Chris@0 402 if (null === $var) {
Chris@0 403 return false;
Chris@0 404 }
Chris@0 405 $encoding = self::$internalEncoding;
Chris@0 406 }
Chris@0 407
Chris@0 408 return self::mb_detect_encoding($var, array($encoding)) || false !== @iconv($encoding, $encoding, $var);
Chris@0 409 }
Chris@0 410
Chris@0 411 public static function mb_detect_encoding($str, $encodingList = null, $strict = false)
Chris@0 412 {
Chris@0 413 if (null === $encodingList) {
Chris@0 414 $encodingList = self::$encodingList;
Chris@0 415 } else {
Chris@16 416 if (!\is_array($encodingList)) {
Chris@0 417 $encodingList = array_map('trim', explode(',', $encodingList));
Chris@0 418 }
Chris@0 419 $encodingList = array_map('strtoupper', $encodingList);
Chris@0 420 }
Chris@0 421
Chris@0 422 foreach ($encodingList as $enc) {
Chris@0 423 switch ($enc) {
Chris@0 424 case 'ASCII':
Chris@0 425 if (!preg_match('/[\x80-\xFF]/', $str)) {
Chris@0 426 return $enc;
Chris@0 427 }
Chris@0 428 break;
Chris@0 429
Chris@0 430 case 'UTF8':
Chris@0 431 case 'UTF-8':
Chris@0 432 if (preg_match('//u', $str)) {
Chris@0 433 return 'UTF-8';
Chris@0 434 }
Chris@0 435 break;
Chris@0 436
Chris@0 437 default:
Chris@0 438 if (0 === strncmp($enc, 'ISO-8859-', 9)) {
Chris@0 439 return $enc;
Chris@0 440 }
Chris@0 441 }
Chris@0 442 }
Chris@0 443
Chris@0 444 return false;
Chris@0 445 }
Chris@0 446
Chris@0 447 public static function mb_detect_order($encodingList = null)
Chris@0 448 {
Chris@0 449 if (null === $encodingList) {
Chris@0 450 return self::$encodingList;
Chris@0 451 }
Chris@0 452
Chris@16 453 if (!\is_array($encodingList)) {
Chris@0 454 $encodingList = array_map('trim', explode(',', $encodingList));
Chris@0 455 }
Chris@0 456 $encodingList = array_map('strtoupper', $encodingList);
Chris@0 457
Chris@0 458 foreach ($encodingList as $enc) {
Chris@0 459 switch ($enc) {
Chris@0 460 default:
Chris@0 461 if (strncmp($enc, 'ISO-8859-', 9)) {
Chris@0 462 return false;
Chris@0 463 }
Chris@17 464 // no break
Chris@0 465 case 'ASCII':
Chris@0 466 case 'UTF8':
Chris@0 467 case 'UTF-8':
Chris@0 468 }
Chris@0 469 }
Chris@0 470
Chris@0 471 self::$encodingList = $encodingList;
Chris@0 472
Chris@0 473 return true;
Chris@0 474 }
Chris@0 475
Chris@0 476 public static function mb_strlen($s, $encoding = null)
Chris@0 477 {
Chris@12 478 $encoding = self::getEncoding($encoding);
Chris@12 479 if ('CP850' === $encoding || 'ASCII' === $encoding) {
Chris@16 480 return \strlen($s);
Chris@0 481 }
Chris@0 482
Chris@0 483 return @iconv_strlen($s, $encoding);
Chris@0 484 }
Chris@0 485
Chris@0 486 public static function mb_strpos($haystack, $needle, $offset = 0, $encoding = null)
Chris@0 487 {
Chris@0 488 $encoding = self::getEncoding($encoding);
Chris@12 489 if ('CP850' === $encoding || 'ASCII' === $encoding) {
Chris@12 490 return strpos($haystack, $needle, $offset);
Chris@12 491 }
Chris@0 492
Chris@12 493 $needle = (string) $needle;
Chris@12 494 if ('' === $needle) {
Chris@0 495 trigger_error(__METHOD__.': Empty delimiter', E_USER_WARNING);
Chris@0 496
Chris@0 497 return false;
Chris@0 498 }
Chris@0 499
Chris@0 500 return iconv_strpos($haystack, $needle, $offset, $encoding);
Chris@0 501 }
Chris@0 502
Chris@0 503 public static function mb_strrpos($haystack, $needle, $offset = 0, $encoding = null)
Chris@0 504 {
Chris@0 505 $encoding = self::getEncoding($encoding);
Chris@12 506 if ('CP850' === $encoding || 'ASCII' === $encoding) {
Chris@12 507 return strrpos($haystack, $needle, $offset);
Chris@12 508 }
Chris@0 509
Chris@0 510 if ($offset != (int) $offset) {
Chris@0 511 $offset = 0;
Chris@0 512 } elseif ($offset = (int) $offset) {
Chris@0 513 if ($offset < 0) {
Chris@0 514 $haystack = self::mb_substr($haystack, 0, $offset, $encoding);
Chris@0 515 $offset = 0;
Chris@0 516 } else {
Chris@0 517 $haystack = self::mb_substr($haystack, $offset, 2147483647, $encoding);
Chris@0 518 }
Chris@0 519 }
Chris@0 520
Chris@0 521 $pos = iconv_strrpos($haystack, $needle, $encoding);
Chris@0 522
Chris@0 523 return false !== $pos ? $offset + $pos : false;
Chris@0 524 }
Chris@0 525
Chris@0 526 public static function mb_strtolower($s, $encoding = null)
Chris@0 527 {
Chris@0 528 return self::mb_convert_case($s, MB_CASE_LOWER, $encoding);
Chris@0 529 }
Chris@0 530
Chris@0 531 public static function mb_strtoupper($s, $encoding = null)
Chris@0 532 {
Chris@0 533 return self::mb_convert_case($s, MB_CASE_UPPER, $encoding);
Chris@0 534 }
Chris@0 535
Chris@0 536 public static function mb_substitute_character($c = null)
Chris@0 537 {
Chris@0 538 if (0 === strcasecmp($c, 'none')) {
Chris@0 539 return true;
Chris@0 540 }
Chris@0 541
Chris@0 542 return null !== $c ? false : 'none';
Chris@0 543 }
Chris@0 544
Chris@0 545 public static function mb_substr($s, $start, $length = null, $encoding = null)
Chris@0 546 {
Chris@0 547 $encoding = self::getEncoding($encoding);
Chris@12 548 if ('CP850' === $encoding || 'ASCII' === $encoding) {
Chris@12 549 return substr($s, $start, null === $length ? 2147483647 : $length);
Chris@12 550 }
Chris@0 551
Chris@0 552 if ($start < 0) {
Chris@0 553 $start = iconv_strlen($s, $encoding) + $start;
Chris@0 554 if ($start < 0) {
Chris@0 555 $start = 0;
Chris@0 556 }
Chris@0 557 }
Chris@0 558
Chris@0 559 if (null === $length) {
Chris@0 560 $length = 2147483647;
Chris@0 561 } elseif ($length < 0) {
Chris@0 562 $length = iconv_strlen($s, $encoding) + $length - $start;
Chris@0 563 if ($length < 0) {
Chris@0 564 return '';
Chris@0 565 }
Chris@0 566 }
Chris@0 567
Chris@12 568 return (string) iconv_substr($s, $start, $length, $encoding);
Chris@0 569 }
Chris@0 570
Chris@0 571 public static function mb_stripos($haystack, $needle, $offset = 0, $encoding = null)
Chris@0 572 {
Chris@0 573 $haystack = self::mb_convert_case($haystack, self::MB_CASE_FOLD, $encoding);
Chris@0 574 $needle = self::mb_convert_case($needle, self::MB_CASE_FOLD, $encoding);
Chris@0 575
Chris@0 576 return self::mb_strpos($haystack, $needle, $offset, $encoding);
Chris@0 577 }
Chris@0 578
Chris@0 579 public static function mb_stristr($haystack, $needle, $part = false, $encoding = null)
Chris@0 580 {
Chris@0 581 $pos = self::mb_stripos($haystack, $needle, 0, $encoding);
Chris@0 582
Chris@0 583 return self::getSubpart($pos, $part, $haystack, $encoding);
Chris@0 584 }
Chris@0 585
Chris@0 586 public static function mb_strrchr($haystack, $needle, $part = false, $encoding = null)
Chris@0 587 {
Chris@0 588 $encoding = self::getEncoding($encoding);
Chris@12 589 if ('CP850' === $encoding || 'ASCII' === $encoding) {
Chris@12 590 return strrchr($haystack, $needle, $part);
Chris@12 591 }
Chris@0 592 $needle = self::mb_substr($needle, 0, 1, $encoding);
Chris@0 593 $pos = iconv_strrpos($haystack, $needle, $encoding);
Chris@0 594
Chris@0 595 return self::getSubpart($pos, $part, $haystack, $encoding);
Chris@0 596 }
Chris@0 597
Chris@0 598 public static function mb_strrichr($haystack, $needle, $part = false, $encoding = null)
Chris@0 599 {
Chris@0 600 $needle = self::mb_substr($needle, 0, 1, $encoding);
Chris@0 601 $pos = self::mb_strripos($haystack, $needle, $encoding);
Chris@0 602
Chris@0 603 return self::getSubpart($pos, $part, $haystack, $encoding);
Chris@0 604 }
Chris@0 605
Chris@0 606 public static function mb_strripos($haystack, $needle, $offset = 0, $encoding = null)
Chris@0 607 {
Chris@0 608 $haystack = self::mb_convert_case($haystack, self::MB_CASE_FOLD, $encoding);
Chris@0 609 $needle = self::mb_convert_case($needle, self::MB_CASE_FOLD, $encoding);
Chris@0 610
Chris@0 611 return self::mb_strrpos($haystack, $needle, $offset, $encoding);
Chris@0 612 }
Chris@0 613
Chris@0 614 public static function mb_strstr($haystack, $needle, $part = false, $encoding = null)
Chris@0 615 {
Chris@0 616 $pos = strpos($haystack, $needle);
Chris@0 617 if (false === $pos) {
Chris@0 618 return false;
Chris@0 619 }
Chris@0 620 if ($part) {
Chris@0 621 return substr($haystack, 0, $pos);
Chris@0 622 }
Chris@0 623
Chris@0 624 return substr($haystack, $pos);
Chris@0 625 }
Chris@0 626
Chris@0 627 public static function mb_get_info($type = 'all')
Chris@0 628 {
Chris@0 629 $info = array(
Chris@0 630 'internal_encoding' => self::$internalEncoding,
Chris@0 631 'http_output' => 'pass',
Chris@0 632 'http_output_conv_mimetypes' => '^(text/|application/xhtml\+xml)',
Chris@0 633 'func_overload' => 0,
Chris@0 634 'func_overload_list' => 'no overload',
Chris@0 635 'mail_charset' => 'UTF-8',
Chris@0 636 'mail_header_encoding' => 'BASE64',
Chris@0 637 'mail_body_encoding' => 'BASE64',
Chris@0 638 'illegal_chars' => 0,
Chris@0 639 'encoding_translation' => 'Off',
Chris@0 640 'language' => self::$language,
Chris@0 641 'detect_order' => self::$encodingList,
Chris@0 642 'substitute_character' => 'none',
Chris@0 643 'strict_detection' => 'Off',
Chris@0 644 );
Chris@0 645
Chris@0 646 if ('all' === $type) {
Chris@0 647 return $info;
Chris@0 648 }
Chris@0 649 if (isset($info[$type])) {
Chris@0 650 return $info[$type];
Chris@0 651 }
Chris@0 652
Chris@0 653 return false;
Chris@0 654 }
Chris@0 655
Chris@0 656 public static function mb_http_input($type = '')
Chris@0 657 {
Chris@0 658 return false;
Chris@0 659 }
Chris@0 660
Chris@0 661 public static function mb_http_output($encoding = null)
Chris@0 662 {
Chris@0 663 return null !== $encoding ? 'pass' === $encoding : 'pass';
Chris@0 664 }
Chris@0 665
Chris@0 666 public static function mb_strwidth($s, $encoding = null)
Chris@0 667 {
Chris@0 668 $encoding = self::getEncoding($encoding);
Chris@0 669
Chris@0 670 if ('UTF-8' !== $encoding) {
Chris@0 671 $s = iconv($encoding, 'UTF-8//IGNORE', $s);
Chris@0 672 }
Chris@0 673
Chris@0 674 $s = preg_replace('/[\x{1100}-\x{115F}\x{2329}\x{232A}\x{2E80}-\x{303E}\x{3040}-\x{A4CF}\x{AC00}-\x{D7A3}\x{F900}-\x{FAFF}\x{FE10}-\x{FE19}\x{FE30}-\x{FE6F}\x{FF00}-\x{FF60}\x{FFE0}-\x{FFE6}\x{20000}-\x{2FFFD}\x{30000}-\x{3FFFD}]/u', '', $s, -1, $wide);
Chris@0 675
Chris@0 676 return ($wide << 1) + iconv_strlen($s, 'UTF-8');
Chris@0 677 }
Chris@0 678
Chris@0 679 public static function mb_substr_count($haystack, $needle, $encoding = null)
Chris@0 680 {
Chris@0 681 return substr_count($haystack, $needle);
Chris@0 682 }
Chris@0 683
Chris@0 684 public static function mb_output_handler($contents, $status)
Chris@0 685 {
Chris@0 686 return $contents;
Chris@0 687 }
Chris@0 688
Chris@0 689 public static function mb_chr($code, $encoding = null)
Chris@0 690 {
Chris@0 691 if (0x80 > $code %= 0x200000) {
Chris@16 692 $s = \chr($code);
Chris@0 693 } elseif (0x800 > $code) {
Chris@16 694 $s = \chr(0xC0 | $code >> 6).\chr(0x80 | $code & 0x3F);
Chris@0 695 } elseif (0x10000 > $code) {
Chris@16 696 $s = \chr(0xE0 | $code >> 12).\chr(0x80 | $code >> 6 & 0x3F).\chr(0x80 | $code & 0x3F);
Chris@0 697 } else {
Chris@16 698 $s = \chr(0xF0 | $code >> 18).\chr(0x80 | $code >> 12 & 0x3F).\chr(0x80 | $code >> 6 & 0x3F).\chr(0x80 | $code & 0x3F);
Chris@0 699 }
Chris@0 700
Chris@0 701 if ('UTF-8' !== $encoding = self::getEncoding($encoding)) {
Chris@0 702 $s = mb_convert_encoding($s, $encoding, 'UTF-8');
Chris@0 703 }
Chris@0 704
Chris@0 705 return $s;
Chris@0 706 }
Chris@0 707
Chris@0 708 public static function mb_ord($s, $encoding = null)
Chris@0 709 {
Chris@0 710 if ('UTF-8' !== $encoding = self::getEncoding($encoding)) {
Chris@0 711 $s = mb_convert_encoding($s, 'UTF-8', $encoding);
Chris@0 712 }
Chris@0 713
Chris@17 714 if (1 === \strlen($s)) {
Chris@17 715 return \ord($s);
Chris@17 716 }
Chris@17 717
Chris@0 718 $code = ($s = unpack('C*', substr($s, 0, 4))) ? $s[1] : 0;
Chris@0 719 if (0xF0 <= $code) {
Chris@0 720 return (($code - 0xF0) << 18) + (($s[2] - 0x80) << 12) + (($s[3] - 0x80) << 6) + $s[4] - 0x80;
Chris@0 721 }
Chris@0 722 if (0xE0 <= $code) {
Chris@0 723 return (($code - 0xE0) << 12) + (($s[2] - 0x80) << 6) + $s[3] - 0x80;
Chris@0 724 }
Chris@0 725 if (0xC0 <= $code) {
Chris@0 726 return (($code - 0xC0) << 6) + $s[2] - 0x80;
Chris@0 727 }
Chris@0 728
Chris@0 729 return $code;
Chris@0 730 }
Chris@0 731
Chris@0 732 private static function getSubpart($pos, $part, $haystack, $encoding)
Chris@0 733 {
Chris@0 734 if (false === $pos) {
Chris@0 735 return false;
Chris@0 736 }
Chris@0 737 if ($part) {
Chris@0 738 return self::mb_substr($haystack, 0, $pos, $encoding);
Chris@0 739 }
Chris@0 740
Chris@0 741 return self::mb_substr($haystack, $pos, null, $encoding);
Chris@0 742 }
Chris@0 743
Chris@12 744 private static function html_encoding_callback(array $m)
Chris@0 745 {
Chris@0 746 $i = 1;
Chris@0 747 $entities = '';
Chris@0 748 $m = unpack('C*', htmlentities($m[0], ENT_COMPAT, 'UTF-8'));
Chris@0 749
Chris@0 750 while (isset($m[$i])) {
Chris@0 751 if (0x80 > $m[$i]) {
Chris@16 752 $entities .= \chr($m[$i++]);
Chris@0 753 continue;
Chris@0 754 }
Chris@0 755 if (0xF0 <= $m[$i]) {
Chris@0 756 $c = (($m[$i++] - 0xF0) << 18) + (($m[$i++] - 0x80) << 12) + (($m[$i++] - 0x80) << 6) + $m[$i++] - 0x80;
Chris@0 757 } elseif (0xE0 <= $m[$i]) {
Chris@0 758 $c = (($m[$i++] - 0xE0) << 12) + (($m[$i++] - 0x80) << 6) + $m[$i++] - 0x80;
Chris@0 759 } else {
Chris@0 760 $c = (($m[$i++] - 0xC0) << 6) + $m[$i++] - 0x80;
Chris@0 761 }
Chris@0 762
Chris@0 763 $entities .= '&#'.$c.';';
Chris@0 764 }
Chris@0 765
Chris@0 766 return $entities;
Chris@0 767 }
Chris@0 768
Chris@17 769 private static function title_case(array $s)
Chris@0 770 {
Chris@17 771 return self::mb_convert_case($s[1], MB_CASE_UPPER, 'UTF-8').self::mb_convert_case($s[2], MB_CASE_LOWER, 'UTF-8');
Chris@0 772 }
Chris@0 773
Chris@0 774 private static function getData($file)
Chris@0 775 {
Chris@0 776 if (file_exists($file = __DIR__.'/Resources/unidata/'.$file.'.php')) {
Chris@0 777 return require $file;
Chris@0 778 }
Chris@0 779
Chris@0 780 return false;
Chris@0 781 }
Chris@0 782
Chris@0 783 private static function getEncoding($encoding)
Chris@0 784 {
Chris@0 785 if (null === $encoding) {
Chris@0 786 return self::$internalEncoding;
Chris@0 787 }
Chris@0 788
Chris@0 789 $encoding = strtoupper($encoding);
Chris@0 790
Chris@0 791 if ('8BIT' === $encoding || 'BINARY' === $encoding) {
Chris@0 792 return 'CP850';
Chris@0 793 }
Chris@0 794 if ('UTF8' === $encoding) {
Chris@0 795 return 'UTF-8';
Chris@0 796 }
Chris@0 797
Chris@0 798 return $encoding;
Chris@0 799 }
Chris@0 800 }