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

# grapheme_strlen

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

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

### 説明

手続き型

function grapheme_strlen(string `$string`): int|false|null

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

### パラメータ

`string`

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

### 戻り値

成功した場合に文字列の長さを返します。 失敗した場合は `null` または `false` を返します。

### 例

例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() - 文字列の長さを得る

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