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

    mb_str_split(string $string, int $length = 1, ?string $encoding = null): array

    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 ou null, 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.

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicionar nota

    Notas de Usuários 2 notes

    up
    7
    webmaster at redinfo dot co dot kr
    3 years ago
    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;
    }
}
    up
    6
    info at ensostudio dot ru
    5 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;
}
?>
    ＋adicionar nota
    To Top