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