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

در این بخش، به بررسی متد contentEquals() در جاوا می‌پردازیم که به شما کمک می‌کند بررسی کنید که آیا یک رشته (String) دقیقاً همان رشته یا دنباله‌ای از کاراکترها را در خود دارد یا نه. بیایید این مفهوم را با جزئیات بیشتر بشکافیم.

تعریف و استفاده

متد contentEquals() در جاوا برای این استفاده می‌شود که بررسی کنید آیا یک رشته، همان دنباله از کاراکترهایی که شما مشخص کرده‌اید را دارد یا نه.

اگر دنباله از کاراکترها در رشته موجود باشد، مقدار true برمی‌گرداند.
اگر دنباله از کاراکترها موجود نباشد، مقدار false برمی‌گرداند.

مثال عملی:

String myStr = "Hello";
System.out.println(myStr.contentEquals("Hello"));  // true
System.out.println(myStr.contentEquals("e"));      // false
System.out.println(myStr.contentEquals("Hi"));     // false

در مثال بالا:

برای اولین خط، چون دنباله دقیقاً “Hello” است، true باز می‌گردد.
در خط دوم، چون “e” فقط یک حرف است و با “Hello” برابر نیست، false برمی‌گردد.
در خط سوم، چون “Hi” با “Hello” مطابقت ندارد، دوباره false برمی‌گردد.

سینتکس (Syntax)

برای استفاده از این متد، دو حالت سینتکس (ساختار) وجود دارد:

با استفاده از StringBuffer:

public boolean contentEquals(StringBuffer chars)

2. با استفاده از CharSequence:

public boolean contentEquals(CharSequence chars)

در اینجا، StringBuffer نوعی از رشته است که می‌تواند تغییرات را در خود ذخیره کند. اما CharSequence یک واسط است که به شما امکان می‌دهد با انواع مختلفی از داده‌های رشته‌ای کار کنید.

توضیحات پارامترها (Parameter Values)

StringBuffer chars: یک شی از کلاس StringBuffer که باید در آن دنباله کاراکترها را جستجو کنید.
CharSequence chars: یک دنباله کاراکتر که می‌خواهید بررسی کنید آیا در رشته شما وجود دارد یا خیر.

نکته مهم: کلاس StringBuffer به شما این امکان را می‌دهد که محتوای آن را تغییر دهید، در حالی که String نمی‌تواند تغییر کند.

جزئیات فنی (Technical Details)

خروجی (Return):
- true اگر دنباله کاراکترهای دقیقاً مشابه پیدا شود.
- false اگر دنباله کاراکترها پیدا نشود.
نسخه جاوا:
- از نسخه 1.4 به بعد برای StringBuffer.
- از نسخه 1.5 به بعد برای CharSequence.

تمرین عملی

برای فهم بهتر، می‌توانید یک برنامه بنویسید که دو رشته مختلف را با هم مقایسه کند و از contentEquals() استفاده کند. به عنوان مثال:

یک رشته myStr با مقدار “Java Programming” بسازید.
سپس بررسی کنید که آیا این رشته دقیقاً مشابه “Java Programming” یا “Java” است.
نتیجه را چاپ کنید تا ببینید چگونه متد عمل می‌کند.

چالش برای شما: چطور می‌توانید از این متد برای بررسی صحت یک پسورد استفاده کنید؟ برای این کار می‌توانید یک رشته پسورد را با پسورد وارد شده توسط کاربر مقایسه کنید و نتیجه را چاپ کنید.