(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.
string
A string a ser decodificada.
start
O 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.
width
A 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_marker
Uma string que é adicionada ao final de string quando a string é truncada.
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.
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 start s e width s negativos.
|
Exemplo #1 Exemplo de mb_strimwidth()
<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// saída: "Hello W..."
?>