Implement grapheme_mask() function

[sepehrphpr]

Description

Adds grapheme_mask() function to the intl extension for Unicode-aware string masking.

Features

• Masks a portion of a string based on grapheme clusters (not bytes)
• Supports Unicode grapheme clusters including emoji sequences, combining characters, and ZWJ sequences
• Proper validation of mask character (must be exactly one grapheme cluster)
• Similar interface to substr() with offset and length parameters

Implementation

• New function in ext/intl/grapheme.c
• Helper functions in grapheme_util.h
• Comprehensive tests in ext/intl/tests/grapheme_mask.phpt

Examples

grapheme_mask("Hello World", "*", 3, 2); // "Hello **rld"
grapheme_mask("سلام دنیا", "#", 2, 3);   // "سا###نیا"
grapheme_mask("👨‍👩‍👧‍👦 Family", "•", 0, 1); // "• Family"

## RFC
Implements RFC: https://wiki.php.net/rfc/grapheme_mask

[youkidearitai]

Thank you very much for your pull request.
But your master branch is seems old, Could you rebase origin/master? (PHP License is out of date, Modified-BSD license in PHP 8.6)
And, your patch infinite loop when compiling. Please fix them.

[LamentXU123]

This doesn't only add grapheme_mask function. Please be clear in documenting what your changes bring for people to review.

Also, this very much requires a RFC, see how to create a RFC here

[youkidearitai]

RFC is here: https://wiki.php.net/rfc/grapheme_mask
(Please write description)

[LamentXU123]

I see. Thank you.
(edited) You may also need to fix the License header in files you've changed.

[sepehrphpr]

Hey Yivo, Thanks for the review and the pointers. About the infinite loop you mentioned – can you clarify exactly where you see that happening? I’m using U8_NEXT and u_strFromUTF8 for UTF-8 validation in grapheme_mask.c, and I thought there’s no loop issue. If you can point me to the specific line or logic, that’d help me fix it quickly. Tomorrow I’ll also update the PR description and add the RFC link. Thanks again for your time! 🙏 Sepehr در تاریخ یکشنبه ۵ ژوئیه ۲۰۲۶، ۱۷:۴۹ tekimen ***@***.***> نوشت:

…

*youkidearitai* left a comment (php/php-src#22605) <#22605 (comment)> RFC is here: https://wiki.php.net/rfc/grapheme_mask (Please write description) — Reply to this email directly, view it on GitHub <#22605?email_source=notifications&email_token=CHGV3GQ6RT2J4YSJLJFENET5DJPW5A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBYGYZTKNJUHE42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#issuecomment-4886355499>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/CHGV3GTQDN6XIMWAVEYUDJL5DJPW5AVCNFSNUABDKJSXA33TNF2G64TZHMYTSMBTGUZDEO2JONZXKZJ3GQ4DCMRXGM2DMOBTUF3AE> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/CHGV3GX6OAWM7CSWQKA4HB35DJPW5A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBYGYZTKNJUHE42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/CHGV3GQP7PWZ6BGNEH7EUZ35DJPW5A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBYGYZTKNJUHE42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>