grapheme_strlen
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
grapheme_strlen — Get string length in grapheme units
说明
过程化风格
Get string length in grapheme units (not bytes or characters)
参数
string
The string being measured for length. It must be a valid UTF-8 string.
示例
示例 #1 grapheme_strlen() 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_strlen( 'abc' . $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd);
?>以上示例会输出:
6
示例 #2 Handling invalid UTF-8 input
grapheme_strlen() returns null or false on failure, including
when the input is not valid UTF-8.
Use intl_get_error_code() and intl_error_name()
to retrieve the ICU error details.
<?php
$string = "\xFF"; // invalid UTF-8 byte sequence
$length = grapheme_strlen($string);
if (!is_int($length)) {
$code = intl_get_error_code();
printf("grapheme_strlen() failed: %s (%d)\n", intl_error_name($code), $code);
} else {
echo $length, PHP_EOL;
}
?>以上示例会输出:
grapheme_strlen() failed: U_INVALID_CHAR_FOUND (10)
参见
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
- iconv_strlen() - 返回字符串的字符数统计
- mb_strlen() - 获取字符串的长度
- strlen() - 获取字符串长度
- intl_get_error_code() - Get the last error code
- intl_error_name() - Get symbolic name for a given error code
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
