# mb_strimwidth

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

mb_strimwidth — Get truncated string with specified width

### Beschreibung

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

Truncates string `string` to specified `width`, where halfwidth characters count as `1`, and fullwidth characters count as `2`. See » http://www.unicode.org/reports/tr11/ for details regarding East Asian character widths.

### Parameter-Liste

`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. If negative width is specified, count from the end of the string.

  > Hinweis:

  > Passing negative width is deprecated as of PHP 8.3.0.

`trim_marker`

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

`encoding`

  Der Parameter `encoding` legt die Zeichenkodierung fest. Wird er nicht übergeben, so wird die interne Zeichenkodierung genutzt.

### Rückgabewerte

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

### Changelog

Version | Beschreibung
--- | ---
8.3.0 | Passing a negative `width` to mb_strimwidth() is now deprecated.
8.0.0 | `encoding` ist nun nullable (akzeptiert den `null`-Wert).
7.1.0 | Support for negative `start`s and `width`s has been added.

### Beispiele

Beispiel #1 mb_strimwidth() example

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

### Siehe auch

- mb_strwidth() - Return width of string
- mb_internal_encoding() - Set/Get internal character encoding

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