grapheme_strpos
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
grapheme_strpos — Find position (in grapheme units) of first occurrence of a string
说明
过程化风格
string
$haystack,string
$needle,int
$offset = 0,string
$locale = ""): int|false
Find position (in grapheme units) of first occurrence of a string
参数
haystack
The string to look in. Must be valid UTF-8.
needle
The string to look for. Must be valid UTF-8.
offset
The optional offset parameter allows you to specify where in haystack to
start searching as an offset in grapheme units (not bytes or characters).
If the offset is negative, it is treated relative to the end of the string.
The position returned is still relative to the beginning of haystack
regardless of the value of offset.
locale
Locale to use. The locale affects how grapheme clusters are defined and
how strings are compared. An empty string or null uses the default
locale.
The locale identifier may include Unicode locale extension keys to
control collation behavior. In particular, the ks
key controls collation strength: for example,
en_US-u-ks-identic enables identical-level
comparison, which distinguishes Unicode variation selectors (such as
emoji vs. text presentation) that are otherwise treated as equivalent.
See Collator::setStrength() for the full
mapping of ks values to collation strength levels.
返回值
Returns the position as an integer. If needle is not found, grapheme_strpos() will return false.
更新日志
| 版本 | 说明 |
|---|---|
| 8.5.0 |
已新增可选参数 locale。
|
| 7.1.0 |
Support for negative offsets has been added.
|
示例
示例 #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
示例 #2 Using the ks-identic locale key to distinguish variation selectors
By default, Unicode variation selectors (U+FE0E text, U+FE0F emoji) are ignored
during comparison. Using the ks-identic locale extension key
enables identical-level collation, which treats them as distinct characters.
注意:
The
localeparameter is available since PHP 8.5.0.
<?php
$textStyle = "\u{263A}\u{FE0E}"; // U+263A + U+FE0E (text presentation selector)
$emojiStyle = "\u{263A}\u{FE0F}"; // U+263A + U+FE0F (emoji presentation selector)
// Default locale: variation selectors are ignored, so the needle is found at position 0.
var_dump(grapheme_strpos($textStyle, $emojiStyle));
// With ks-identic: variation selectors are significant, so no match is found.
var_dump(grapheme_strpos($textStyle, $emojiStyle, 0, 'en_US-u-ks-identic'));
?>以上示例会输出:
int(0) bool(false)
参见
- grapheme_stripos() - Find position (in grapheme units) of first occurrence of a case-insensitive string
- grapheme_stristr() - Returns part of haystack string from the first occurrence of case-insensitive needle to the end of haystack
- grapheme_strripos() - Find position (in grapheme units) of last occurrence of a case-insensitive string
- grapheme_strrpos() - Find position (in grapheme units) of last occurrence of a string
- grapheme_strstr() - Returns part of haystack string from the first occurrence of needle to the end of haystack
- Collator::setStrength() - Set collation strength
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
