if( !function_exists('mb_str_split')){
function mb_str_split( $string = '', $length = 1 , $encoding = null ){
if(!empty($string)){
$split = array();
$mb_strlen = mb_strlen($string,$encoding);
for($pi = 0; $pi < $mb_strlen; $pi += $length){
$substr = mb_substr($string, $pi,$length,$encoding);
if( !empty($substr)){
$split[] = $substr;
}
}
}
return $split;
}
}
mb_str_split
(PHP 7 >= 7.4.0, PHP 8)
mb_str_split — Dada uma string multibyte, retorna um array de seus caracteres
Descrição
Esta função retornará um array de strings, sendo uma versão de str_split() com suporte para codificações de tamanho de caractere variável, bem como codificações de tamanho fixo de caracteres de 1, 2 ou 4 bytes.
Se o parâmetro length for especificado, a string será dividida em partes do comprimento especificado em caracteres (não bytes).
O parâmetro encoding pode ser especificado opcionalmente e é uma boa prática fazê-lo.
Parâmetros
-
string -
A string para dividir em caracteres ou partes.
-
length -
Se especificado, cada elemento do array retornado será composto por vários caracteres em vez de um único caractere.
-
encoding -
O parâmetro
encodingé a codificação de caracteres. Se for omitido ounull, o valor da codificação de caracteres interna será usado.Uma string especificando uma das codificações suportadas.
Valor Retornado
mb_str_split() retorna um array de strings.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.0.0 |
O parâmetro encoding agora pode ser nulo.
|
| 8.0.0 |
Esta função não retorna mais false em caso de falha.
|
add a note
User Contributed Notes 3 notes
webmaster at redinfo dot co dot kr ¶
1 year ago
info at ensostudio dot ru ¶
3 years ago
Note: function return NULL if can't convert argument type.
Polyfill PHP < 7.4 based on package "symfony/polyfill-mbstring":
<?php
function mb_str_split($string, $split_length = 1, $encoding = null)
{
if (null !== $string && !\is_scalar($string) && !(\is_object($string) && \method_exists($string, '__toString'))) {
trigger_error('mb_str_split(): expects parameter 1 to be string, '.\gettype($string).' given', E_USER_WARNING);
return null;
}
if (null !== $split_length && !\is_bool($split_length) && !\is_numeric($split_length)) {
trigger_error('mb_str_split(): expects parameter 2 to be int, '.\gettype($split_length).' given', E_USER_WARNING);
return null;
}
$split_length = (int) $split_length;
if (1 > $split_length) {
trigger_error('mb_str_split(): The length of each segment must be greater than zero', E_USER_WARNING);
return false;
}
if (null === $encoding) {
$encoding = mb_internal_encoding();
} else {
$encoding = (string) $encoding;
}
if (! in_array($encoding, mb_list_encodings(), true)) {
static $aliases;
if ($aliases === null) {
$aliases = [];
foreach (mb_list_encodings() as $encoding) {
$encoding_aliases = mb_encoding_aliases($encoding);
if ($encoding_aliases) {
foreach ($encoding_aliases as $alias) {
$aliases[] = $alias;
}
}
}
}
if (! in_array($encoding, $aliases, true)) {
trigger_error('mb_str_split(): Unknown encoding "'.$encoding.'"', E_USER_WARNING);
return null;
}
}
$result = [];
$length = mb_strlen($string, $encoding);
for ($i = 0; $i < $length; $i += $split_length) {
$result[] = mb_substr($string, $i, $split_length, $encoding);
}
return $result;
}
?>
vovan-ve at yandex dot ru ¶
3 years ago
Lazy polyfill for UTF-8 only:
function utf8_str_split(string $input, int $splitLength = 1)
{
$re = \sprintf('/\\G.{1,%d}+/us', $splitLength);
\preg_match_all($re, $input, $m);
return $m[0];
}
