(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strimwidth — Obtém string truncada com largura especificada
$string,$start,$width,$trim_marker = "",$encoding = null
Trunca a string string para a largura especificada width,
onde caracteres de meia largura contam como 1, e caracteres de largura total
contam como 2.
Consulte » http://www.unicode.org/reports/tr11/
para detalhes sobre larguras de caracteres do leste asiático.
stringA string a ser decodificada.
startO deslocamento da posição inicial. Número de caracteres a partir do início da string (o primeiro caractere é 0), ou se start for negativo, o número de caracteres a partir do final da string.
widthA largura do corte desejado. Se uma largura negativa for especificada, conta a partir do final da string.
Nota:
Passar uma largura negativa foi descontinuado a partir do PHP 8.3.0.
trim_markerUma string que é adicionada ao final de string quando a string é truncada.
encodingO parâmetro encoding
é a codificação de caracteres. Se for omitido ou null, o valor da codificação
de caracteres interna será usado.
A string truncada. Se trim_marker estiver definido,
trim_marker substitui os últimos caracteres para corresponder à width.
| Versão | Descrição |
|---|---|
| 8.3.0 |
Passar uma largura negativa width para
mb_strimwidth() agora foi descontinuado.
|
| 8.0.0 |
O parâmetro encoding agora pode ser nulo.
|
| 7.1.0 |
Adicionado suporte para starts e widths negativos.
|
Exemplo #1 Exemplo de mb_strimwidth()
<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// saída: "Hello W..."
?>