指定した幅で文字列を丸める

# mb_strimwidth

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

mb_strimwidth — 指定した幅で文字列を丸める

### 説明

mb_strimwidth ( string `$str` , int `$start` , int `$width` [, string `$trimmarker` = "" [, string `$encoding` = mb_internal_encoding() ]] ) : string

文字列 `str` を指定した幅 `width` で丸めます。

### パラメータ

`str`

  丸めたい文字列。

`start`

  開始位置のオフセット。文字列の始めからの文字数 (最初の文字は 0) です。 負のオフセットは、文字列の末尾からのオフセットと解釈されます。

`width`

  丸める幅。負の値は、文字列の末尾からの幅を数えます。

`trimmarker`

  丸めた後にその文字列の最後に追加される文字列。

`encoding`

  `encoding` パラメータには文字エンコーディングを指定します。省略した場合は、 内部文字エンコーディングを使用します。

### 返り値

丸められた文字列を返します。 `trimmarker` が設定された場合、 `width` にマッチする最後の文字を `trimmarker` で置き換えます。

### 変更履歴

バージョン | 説明
--- | ---
7.1.0 | 負の `start` と `width` をサポートするようになりました。

### 例

例1 mb_strimwidth() の例

`<?php
echo mb_strimwidth("Hello World", 0, 10, "...");
// "Hello W..." と出力します
?>`

### 参考

- mb_strwidth() - 文字列の幅を返す
- mb_internal_encoding() - 内部文字エンコーディングを設定あるいは取得する