mb_strimwidth

Get truncated string with specified width

&reftitle.description; `string` `mb_strimwidth` `string` `string` `int` `start` `int` `width` `string` `trim_marker`"" ``string``null```encoding`&null;

Truncates `string` `string` to specified `width`, where halfwidth characters count as `1`, and fullwidth characters count as `2`. See &url.unicode.reports.tr;11/ for details regarding East Asian character widths.

&reftitle.parameters;

`string`

- The `string` being decoded.

`start`

- The start position offset. Number of characters from the beginning of string (first character is 0), or if start is negative, number of characters from the end of the string.

`width`

- The width of the desired trim. Negative widths count from the end of the string.

`trim_marker`

- A string that is added to the end of string when string is truncated.

`encoding`

- &mbstring.encoding.parameter;
&reftitle.returnvalues;

The truncated `string`. If `trim_marker` is set, `trim_marker` replaces the last chars to match the `width`.

&reftitle.changelog;

&Version; | &Description;
&mbstring.changelog.encoding-nullable;
7.1.0 | Support for negative `start`s and `width`s has been added.

&reftitle.examples;

### `mb_strimwidth` example

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

&reftitle.seealso;

- `mb_strwidth`
- `mb_internal_encoding`