متد codePointCount() در جاوا

متد codePointCount() در جاوا تعداد کدپوینت‌های یونیکد (Unicode Code Points) را در یک بخش از رشته (String) محاسبه می‌کند. این متد برای شمارش کاراکترهای یونیکد استفاده می‌شود، نه تعداد کاراکترهای معمولی!

🔸 چرا مهم است؟
در برخی زبان‌ها و کاراکترهای خاص (مانند اموجی‌ها 😊) ممکن است یک کاراکتر از چند کدپوینت تشکیل شده باشد. این متد کمک می‌کند تا تعداد واقعی کدپوینت‌ها را در یک محدوده مشخص از رشته محاسبه کنیم.

🛠 سینتکس (Syntax)

public int codePointCount(int startIndex, int endIndex)

🔹 ورودی‌ها:

startIndex ➝ عدد صحیح (int) که نشان‌دهنده شروع بررسی است.
endIndex ➝ عدد صحیح (int) که نشان‌دهنده اولین اندیسی است که در شمارش قرار نمی‌گیرد.

🔹 خروجی:
یک مقدار int که تعداد کدپوینت‌های یونیکد موجود در بازه مشخص‌شده را نشان می‌دهد.

🔹 خطاهای احتمالی (Exception):
اگر:

startIndex مقدار منفی داشته باشد.
endIndex بزرگ‌تر از طول رشته باشد.
مقدار startIndex از endIndex بزرگ‌تر باشد.
👉 در این صورت استثنای IndexOutOfBoundsException رخ می‌دهد.

🎯 مثال کاربردی

بیایید یک مثال ساده ببینیم:

public class Main {
    public static void main(String[] args) {
        String myStr = "Hello";
        int result = myStr.codePointCount(0, 5);
        System.out.println(result); // خروجی: 5
    }
}

🔹 در این مثال:

رشته “Hello” پنج کاراکتر دارد.
از ایندکس 0 تا 5 شمارش انجام می‌شود.
خروجی 5 است، چون هر کاراکتر یک کدپوینت یونیکد مستقل دارد.

🧐 مثال پیشرفته‌تر: تأثیر اموجی‌ها!

حالا فرض کنید از یک اموجی استفاده کنیم که بیش از یک کدپوینت دارد:

public class Main {
    public static void main(String[] args) {
        String myStr = "Hi !";
        int result = myStr.codePointCount(0, myStr.length());
        System.out.println(result); // خروجی: 4
    }
}

🔹 رشته "Hi 😊!" در نگاه اول 5 کاراکتر دارد، اما:

H و i هر کدام یک کدپوینت دارند.
اموجی 😊 در واقع دو کدپوینت یونیکد دارد!
! هم یک کدپوینت دارد.
📌 پس در مجموع 4 کدپوینت داریم، نه 5!

🏆 چالش برای شما 🎯

1️⃣ یک رشته حاوی اموجی یا حروف خاص یونیکد بسازید.
2️⃣ با استفاده از codePointCount() تعداد واقعی کدپوینت‌ها را پیدا کنید.
3️⃣ آیا تعداد کدپوینت‌ها با تعداد کاراکترها برابر است؟ چرا؟