書記素単位で文字列の長さを取得する

# grapheme_strlen

(PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.0)

grapheme_strlen — 書記素単位で文字列の長さを取得する

### 説明

手続き型

grapheme_strlen ( string `$input` ) : int

書記素単位 (バイト数や文字数ではありません) で文字列の長さを取得します。

### パラメータ

`input`

  長さを調べたい文字列。正しい形式の UTF-8 でなければなりません。

### 返り値

成功した場合に文字列の長さ。文字列が空の場合に 0 を返します。

### 例

例1 grapheme_strlen() の例

`<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print grapheme_strlen( 'abc' . $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd);
?>`

上の例の出力は以下となります。

    6

### 参考

- » Unicode Text Segmentation: Grapheme Cluster Boundaries
- iconv_strlen() - 文字列の文字数を返す
- mb_strlen() - 文字列の長さを得る
- strlen() - 文字列の長さを得る