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

参考

  • grapheme_stripos() - 大文字小文字を区別せず、文字列内で最初にあらわれる場所の (書記素単位の) 位置を見つける
  • grapheme_stristr() - 大文字小文字を区別せず、haystack 文字列の中で needle が最初に登場した場所以降の部分文字列を返す
  • grapheme_strripos() - 大文字小文字を区別せず、文字列内で最後にあらわれる場所の (書記素単位の) 位置を見つける
  • grapheme_strrpos() - 文字列内で最後にあらわれる場所の (書記素単位の) 位置を見つける
  • grapheme_strstr() - haystack 文字列の中で、needle が最初に登場した場所以降の部分文字列を返す
  • »  Unicode Text Segmentation: Grapheme Cluster Boundaries

関連キーワード:  位置, 場所, 単位, grapheme, 最初, haystack, strpos, offset, 大文字, 小文字