mb_substr

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_substr — Obtém parte da string

Descrição

mb_substr(
    string $string,
    int $start,
    ?int $length = null,
    ?string $encoding = null
): string

Realiza uma operação de substr() segura para múltiplos bytes baseada no número de caracteres. A posição é contada a partir do início de string. A posição do primeiro caractere é 0. A posição do segundo caractere é 1, e assim por diante.

Parâmetros

string

A string da qual extrair a substring.

start

Se start for não negativo, a string retornada começará na posição start-ésima em string, contando a partir de zero. Por exemplo, na string 'abcdef', o caractere na posição 0 é 'a', o caractere na posição 2 é 'c', e assim por diante.

Se start for negativo, a string retornada começará no caractere start-ésimo a partir do final de string.

length

Número máximo de caracteres a serem usados de string. Se omitido ou NULL for passado, extrai todos os caracteres até o final da string.

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.

Valor Retornado

mb_substr() retorna a porção de string especificada pelos parâmetros start e length.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro encoding agora pode ser nulo.

Veja Também