(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strcut — Obtém parte da string
mb_strcut() extrai uma substring de uma string de forma semelhante a mb_substr(), mas opera em bytes em vez de caracteres. Se a posição de corte estiver entre dois bytes de um caractere multibyte, o corte é realizado a partir do primeiro byte desse caractere. Essa também é a diferença para a função substr(), que simplesmente cortaria a string entre os bytes e resultaria em uma sequência de bytes malformada.
stringA string a ser cortada.
start
Se start for não negativo, a string retornada
começará na posição de byte start
em string, contando a partir do zero. Por exemplo,
na string 'abcdef', o byte na
posição 0 é 'a', o
byte na posição 2 é
'c', e assim por diante.
Se start for negativo, a string retornada
começará no byte start
contando a partir do final de string. No entanto, se o
valor absoluto de um start negativo for maior que o
comprimento da string, a parte retornada começará do início de
string.
length
Comprimento em bytes. Se omitido ou NULL
for passado, extrai todos os bytes até o final da string.
Se length for negativo, a string retornada
terminará no byte de número length
contando a partir do final de string. No entanto, se o
valor absoluto de um length negativo for maior que o
número de caracteres após a posição de start, uma string vazia será
retornada.
encodingO parâmetro encoding
é a codificação de caracteres. Se for omitido ou null, o valor da codificação
de caracteres interna será usado.
mb_strcut() retorna a parte de
string especificada pelos
parâmetros start e
length.
| Versão | Descrição |
|---|---|
| 8.0.0 |
O parâmetro encoding agora pode ser nulo.
|