rfc:grapheme_str_split
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
| rfc:grapheme_str_split [2024/03/04 00:35] – created youkidearitai | rfc:grapheme_str_split [2024/04/10 19:21] (current) – Implemented grapheme_str_split function youkidearitai | ||
|---|---|---|---|
| Line 3: | Line 3: | ||
| * Date: 2024-03-04 | * Date: 2024-03-04 | ||
| * Author: Yuya Hamada, youkidearitai@gmail.com | * Author: Yuya Hamada, youkidearitai@gmail.com | ||
| - | * Status: | + | * Status: |
| * First Published at: http:// | * First Published at: http:// | ||
| ===== Introduction ===== | ===== Introduction ===== | ||
| - | I noticed PHP does not have a grapheme cluster based str_split function. So I think need str_split for grapheme cluster, grapheme_str_split function. | + | I noticed PHP does not have a grapheme cluster based str_split function. So I think need str_split for grapheme cluster, grapheme_str_split function |
| - | This feature will allow to correctly | + | grapheme_str_split function is correctly |
| + | < | ||
| + | $ sapi/ | ||
| + | array(1) { | ||
| + | [0]=> | ||
| + | string(13) " | ||
| + | } | ||
| + | </ | ||
| + | For example, compare to mb_str_split function, mb_str_split function is str_split for Unicode codepoint. (Of course, sometimes this is more convenient.) | ||
| + | |||
| + | < | ||
| + | $ sapi/ | ||
| + | array(4) { | ||
| + | [0]=> | ||
| + | string(4) " | ||
| + | [1]=> | ||
| + | string(3) " | ||
| + | [2]=> | ||
| + | string(3) " | ||
| + | [3]=> | ||
| + | string(3) " | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | Until now, PCRE functions were required to support grapheme clusters. | ||
| + | |||
| + | < | ||
| + | $ sapi/ | ||
| + | array(1) { | ||
| + | [0]=> | ||
| + | array(2) { | ||
| + | [0]=> | ||
| + | string(13) " | ||
| + | [1]=> | ||
| + | int(0) | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | Examples of other languages. Ruby is already support grapheme clusters as [[https:// | ||
| + | |||
| + | < | ||
| + | s = " | ||
| + | s.grapheme_clusters | ||
| + | # => [" | ||
| + | </ | ||
| + | |||
| + | grapheme_str_split support to grapheme clusters (variation selectors). | ||
| + | |||
| + | < | ||
| + | $ sapi/ | ||
| + | array(13) { | ||
| + | [0]=> | ||
| + | string(2) " | ||
| + | [1]=> | ||
| + | string(1) " | ||
| + | [2]=> | ||
| + | string(1) " | ||
| + | [3]=> | ||
| + | string(1) " | ||
| + | [4]=> | ||
| + | string(1) " | ||
| + | [5]=> | ||
| + | string(1) " | ||
| + | [6]=> | ||
| + | string(3) " | ||
| + | [7]=> | ||
| + | string(1) " | ||
| + | [8]=> | ||
| + | string(1) " | ||
| + | [9]=> | ||
| + | string(1) " | ||
| + | [10]=> | ||
| + | string(1) " | ||
| + | [11]=> | ||
| + | string(1) " | ||
| + | [12]=> | ||
| + | string(3) " | ||
| + | } | ||
| + | </ | ||
| ===== Proposal ===== | ===== Proposal ===== | ||
| Line 17: | Line 96: | ||
| < | < | ||
| - | function grapheme_str_split(string $string, int $length = 1): array {} | + | function grapheme_str_split(string $string, int $length = 1): array|false |
| </ | </ | ||
| + | |||
| + | $string is only support UTF-8. $length is the length of the grapheme cluster per element of the array. | ||
| ===== Backward Incompatible Changes ===== | ===== Backward Incompatible Changes ===== | ||
| Line 25: | Line 106: | ||
| ===== Proposed PHP Version(s) ===== | ===== Proposed PHP Version(s) ===== | ||
| - | next PHP 8.x | + | PHP 8.4 |
| ===== RFC Impact ===== | ===== RFC Impact ===== | ||
| Line 54: | Line 135: | ||
| ===== Proposed Voting Choices ===== | ===== Proposed Voting Choices ===== | ||
| - | Include these so readers know where you are heading and can discuss the proposed voting options. | + | <doodle title=" |
| + | * Yes | ||
| + | * No | ||
| + | </ | ||
rfc/grapheme_str_split.1709512523.txt.gz · Last modified: 2024/03/04 00:35 by youkidearitai