mb_str_split - PHP code example

The php Function Mb_Str_Split

The php function mb_str_split converts the content of a string into an array. It accepts the string and an optional number of characters that will be separated into each array element if split_length is set. The function also returns a FALSE value if it encounters an empty string.

PHP wasn't designed for multibyte character encodings and it is written in C which doesn't support them natively. This means that many tools and libraries need to use complicated approaches to detect multibyte references in their code.

Prior to PHP 8.2, str_split incorrectly returned an empty array when splitting a string that did not contain any bytes at all. This erroneous behavior was fixed in the Mbstring extension as of PHP 8.2 with the introduction of mb_str_split, which functions similarly to str_split but correctly returns an empty array for empty strings.

If you need to split a multibyte string into an array with a given length of chunks, it is recommended that you use mb_str_split. This function will split the string into arrays of a specified length, and each array will contain the corresponding code point of each character in the string. This is a much more efficient way to work with multibyte strings than the older approach using str_split, which splits the string into chunks but does not account for the fact that some characters take multiple bytes to represent. This is a major improvement and I encourage you to make the switch to mb_str_split in all of your PHP applications.

mb_str_split example

/** @var array<int, string> $onlyScalarValues */
                $onlyScalarValues = $values;
                $values = $this->tokenize($onlyScalarValues, $context);
            }

            foreach ($values as $value) {
                if (!\is_scalar($value)) {
                    continue;
                }

                // even the field is non tokenize, if it reached 500 chars, we should break it anyway                 $parts = array_filter(mb_str_split((string) $value, self::MAXIMUM_KEYWORD_LENGTH));

                foreach ($parts as $part) {
                    $keywords->add(new AnalyzedKeyword((string) $part, $ranking));
                }
            }
        }

        return $keywords;
    }

    /** * @param array<int, string> $values * * @return array<int, string> */

foreach ($groups as $group) {
                foreach ($group as $row) {
                    if ($row instanceof TableSeparator) {
                        continue;
                    }

                    foreach ($row as $i => $cell) {
                        if ($cell instanceof TableCell) {
                            $textContent = Helper::removeDecoration($this->output->getFormatter(), $cell);
                            $textLength = Helper::width($textContent);
                            if ($textLength > 0) {
                                $contentColumns = mb_str_split($textContent, ceil($textLength / $cell->getColspan()));
                                foreach ($contentColumns as $position => $content) {
                                    $row[$i + $position] = $content;
                                }
                            }
                        }
                    }

                    $lengths[] = $this->getCellWidth($row, $column);
                }
            }

if (!function_exists('mb_ord')) {
    function mb_ord($string, $encoding = null) { return p\Mbstring::mb_ord($string, $encoding); }
}
if (!function_exists('mb_chr')) {
    function mb_chr($codepoint, $encoding = null) { return p\Mbstring::mb_chr($codepoint, $encoding); }
}
if (!function_exists('mb_scrub')) {
    function mb_scrub($string, $encoding = null) { $encoding = null === $encoding ? mb_internal_encoding() : $encoding; return mb_convert_encoding($string, $encoding, $encoding); }
}
if (!function_exists('mb_str_split')) {
    function mb_str_split($string, $length = 1, $encoding = null) { return p\Mbstring::mb_str_split($string, $length, $encoding); }
}

if (extension_loaded('mbstring')) {
    return;
}

if (!defined('MB_CASE_UPPER')) {
    define('MB_CASE_UPPER', 0);
}
if (!defined('MB_CASE_LOWER')) {
    define('MB_CASE_LOWER', 1);
}

if (!function_exists('mb_ord')) {
    function mb_ord(?string $string, ?string $encoding = null): int|false { return p\Mbstring::mb_ord((string) $string, $encoding); }
}
if (!function_exists('mb_chr')) {
    function mb_chr(?int $codepoint, ?string $encoding = null): string|false { return p\Mbstring::mb_chr((int) $codepoint, $encoding); }
}
if (!function_exists('mb_scrub')) {
    function mb_scrub(?string $string, ?string $encoding = null): string { $encoding ??= mb_internal_encoding(); return mb_convert_encoding((string) $string, $encoding, $encoding); }
}
if (!function_exists('mb_str_split')) {
    function mb_str_split(?string $string, ?int $length = 1, ?string $encoding = null): array { return p\Mbstring::mb_str_split((string) $string, (int) $length, $encoding); }
}

if (extension_loaded('mbstring')) {
    return;
}

if (!defined('MB_CASE_UPPER')) {
    define('MB_CASE_UPPER', 0);
}
if (!defined('MB_CASE_LOWER')) {
    define('MB_CASE_LOWER', 1);
}