Obtém string truncada com largura especificada

# mb_strimwidth

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

mb_strimwidth — Obtém string truncada com largura especificada

### Descrição

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open