(PHP 5 >= 5.3.0,PHP 7,PHP 8,PECL intl >= 1.0.0)
grapheme_substr — 返回字串的一部分
string (字串)輸入的字串。必須是有效的 UTF-8 編碼。
offset (偏移量)以預設字素單位計算的起始位置。如果 offset 為非負數,則回傳的字串將從 string 中的第 offset 個位置開始,從零開始計算。如果 offset 為負數,則回傳的字串將從 string 結尾的第 offset 個字素單位開始。
length (長度)以字素單位計算的長度。如果給定了 length 且為正數,則回傳的字串將最多包含從 offset 開始的 length 個字素單位(取決於 string 的長度)。如果給定了 length 且為負數,則將從 string 的結尾省略這麼多個字素單位(在 offset 為負數時計算起始位置之後)。如果 offset 表示超出此截斷範圍的位置,則將回傳空字串。
回傳 string 的擷取部分,如果失敗則回傳 false。
| 版本 | 說明 |
|---|---|
| 8.0.0 | 此函數現在會一致地將超出範圍的偏移量限制在字串邊界內。以前,在某些情況下會回傳 false 而不是空字串。 |
範例 #1 grapheme_substr() 範例
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) 正規化格式 "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) 正規化格式 "D"
print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" . $char_o_diaeresis_nfd . "O", 2, -1 ));
?>上述範例將輸出
a%CC%8Abco%CC%88