大网数据广告活动
PHP 语言与运行手册

grapheme_strpos · Find position (in grapheme units) of first occurrence of a string

· 52CE 我爱测

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

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

说明

过程化风格

function grapheme_strpos(
    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 locale parameter 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)

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。