مشخصات مقاله
آموزش Java – کار با تابع string join()
آموزش Java – کار با تابع string join()
متد string join() رشته ی ورودی (المان هایی از جنس رشته) را با کاراکتر تفکیک کننده ی مورد نظر (پارامتر delimiter) به هم متصل کرده و در خروجی آن رشته را بازمی گرداند. در این متد، تفکیک کننده به ازای هر المان کپی می شود.
اگر مقدار پارامتر element برابر "null" باشد، در آن صورت خطا رخ می دهد. متد join() از ویرایش 1.8 ابزار JDK به Java اضافه شده است.
متد join() دارای نسخه ی overload شده می باشد و دو نوع پارامتر دریافت می کند.
Signature متد (اسم متد و پارامترهای ورودی)
اسم و پارامترهای ورودی این متد در زیر به نمایش گذاشته شده اند:
1 | public static String join(CharSequence delimiter, CharSequence... elements)<button></button> |
و
1 | public static String join(CharSequence delimiter, Iterable<!--? extends CharSequence--> elements) <button></button> |
پارامترهای ورودی متد
- delimiter: نشانگر مقدار char یا کاراکتر تفکیک کننده ای است که به هر المان الصاق می گردد.
- elements: مقدار char یا المان های رشته ای که کاراکتر تفکیک کننده به هر یک از آن ها الحاق شده و در خروجی برگردانده می شود.
خروجی
رشته ای که المان های آن با تفکیک کننده مورد نظر به هم چسبانده شده اند را در خروجی برمی گرداند.
صدور خطا
در صورتی که المان یا کاراکتر تفکیک گر دارای مقدار null باشد، خطای NullPointerException رخ می دهد.
ویرایشی که از این متد پشتیبانی می کند
این متد از ویرایش 1.8 در زبان Java معرفی شده و استفاده می شود.
مثال کاربردی از متد join()
1 2 3 4 5 6 | public class StringJoinExample{ public static void main(String args[]){ String joinString1=String.join( "-" , "welcome" , "to" , "javatpoint" ); System.out.println(joinString1); }} <button></button> |
خروجی:
1 | welcome-to-javatpoint<button></button> |