(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 bytestart 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. |