grapheme_strpos

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

    grapheme_strpos — 文字列内で最初にあらわれる場所の (書記素単位の) 位置を見つける

    説明

    手続き型

    grapheme_strpos(string$haystack, string$needle, int$offset = 0): int|false

    文字列内で最初にあらわれる場所の (書記素単位の) 位置を見つけます。

    パラメータ

    haystack

    探す対象となる文字列。正しい形式の UTF-8 でなければなりません。

    needle

    探したい文字列。正しい形式の UTF-8 でなければなりません。

    offset

    オプションの offset パラメータで、haystack のどの位置 (バイト数や文字数ではなく、書記素単位) から探し始めるのかを指定します。 負のオフセットは、文字列の末尾からのオフセットと解釈されます。 offset の値にかかわらず、返される値は常に haystack の先頭からの位置になります。

    戻り値

    位置を表す整数値を返します。needle が見つからない場合は grapheme_strpos() は false を返します。

    変更履歴

    バージョン説明
    7.1.0 負の offset をサポートするようになりました。

    例

    例1 grapheme_strpos() example

    <?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_strpos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_o_diaeresis_nfd);

    ?>

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

    2

    参考

    To Top