mb_strimwidth

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

mb_strimwidth — Obtém string truncada com largura especificada

Descrição

mb_strimwidth(
    string $string,
    int $start,
    int $width,
    string $trim_marker = "",
    ?string $encoding = null
): string

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.

Parâmetros

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.

Valor Retornado

A string truncada. Se trim_marker estiver definido, trim_marker substitui os últimos caracteres para corresponder à width.

Registro de Alterações

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.

Exemplos

Exemplo #1 Exemplo de mb_strimwidth()

<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// saída: "Hello W..."
?>

Veja Também

mb_strwidth() - Retorna a largura da string
mb_internal_encoding() - Define/Obtém a codificação de caracteres interna