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

در این آموزش، می‌خواهیم به شما توضیح بدهیم که متد offsetByCodePoints() در جاوا چه کاری انجام می‌دهد و چگونه می‌توانید از آن استفاده کنید. 📝

تعریف و کاربرد

متد offsetByCodePoints() در جاوا، به شما کمک می‌کند تا موقعیت (ایندکس) یک رشته (String) را پیدا کنید که از یک ایندکس دیگر به اندازه‌ی مشخصی جابجا شده باشد. این جابجایی بر اساس تعداد کد پوینت‌ها (Code Points) است.

نکته:

کد پوینت‌ها (Code Points) به واحدهای کد در جاوا گفته می‌شود. ممکن است یک کد پوینت از بیش از یک کاراکتر تشکیل شده باشد. بنابراین، جابجایی بر اساس کد پوینت‌ها ممکن است ایندکس را بیشتر از 1 تغییر دهد.

سینتکس (Syntax)

public int offsetByCodePoints(int index, int codePointOffset)

پارامترها:

index: این پارامتر ایندکسی است که می‌خواهید جابجایی از آن شروع شود.
codePointOffset: تعداد کد پوینت‌هایی که می‌خواهید ایندکس را از آن جابجا کنید. اگر این مقدار مثبت باشد، ایندکس به جلو حرکت می‌کند و اگر منفی باشد، ایندکس به عقب می‌رود.

خروجی متد

این متد یک عدد صحیح (int) برمی‌گرداند که نشان‌دهنده ایندکسی است که به اندازه‌ی codePointOffset کد پوینت از ایندکس اولیه جابجا شده است.

نکات فنی

این متد در جاوا 1.5 و بالاتر پشتیبانی می‌شود.
اگر index منفی باشد یا بیشتر از طول رشته باشد، یا تعداد کد پوینت‌ها برای جابجایی کافی نباشد، IndexOutOfBoundsException پرتاب می‌شود.

مثال ساده

فرض کنید یک رشته به نام myStr دارید که مقدار آن "Hello, World!" است و می‌خواهید از ایندکس 3 شروع کنید و 2 کد پوینت جابجا شوید.

String myStr = "Hello, World!";
int result = myStr.offsetByCodePoints(3, 2);
System.out.println(result); // خروجی: 5

توضیح مثال:

در ابتدا ایندکس 3 است (که به حرف l مربوط می‌شود).
سپس با استفاده از متد offsetByCodePoints(), شما 2 کد پوینت به جلو می‌روید.
بنابراین، از ایندکس 3 به ایندکس 5 می‌رسید (که حرف o است).

تمرین:

سعی کنید با استفاده از رشته‌های مختلف، تعداد کد پوینت‌ها را امتحان کنید و ببینید چگونه ایندکس‌ها تغییر می‌کنند. آیا می‌توانید ایندکس منفی را امتحان کنید؟ چه اتفاقی می‌افتد؟ 🔍

نتیجه‌گیری

متد offsetByCodePoints() برای جابجایی ایندکس‌ها بر اساس تعداد کد پوینت‌ها بسیار مفید است و به شما کمک می‌کند تا به راحتی ایندکس‌ها را محاسبه کنید. این ابزار در پردازش رشته‌هایی که شامل کد پوینت‌های چند کاراکتری هستند، کاربرد زیادی دارد.