آموزش Java - کار با تابع split() در Java

آموزش Java – کار با تابع split() در Java

متد split() رشته ی مورد نظر بر اساس عبارت باقاعده (پارامتر regex) یا الگوی ارسال شده به عنوان آرگومان به رشته های کوچکتر یا به عبارتی آرایه ای از رشته ها تبدیل می کند و آن را در خروجی برمی گرداند (یک آرایه از رشته ها باز می گرداند).

Signature متد (اسم و پارامترهای ورودی)

این متد دارای یک نسخه ی overload شده بوده و با دو signature متفاوت فراخوانی می شود:

public String split(String regex)

و

public String split(String regex, int limit)

پارامتر ورودی

regex: عبارت باقاعده یا regular expression که کاراکتر تجزیه ی المان های رشته را تعیین کرده و محتوای رشته بر اساس آن از هم جدا می شوند.

limit: این پارامتر حداکثر تعداد المان های موجود در خروجی/آرایه ای از رشته ها را مشخص می کند. اگر برابر 0 باشد، در آن صورت تمامی رشته هایی که با مقدار پارامتر regex منطبق باشند را در خروجی برمی گرداند.

خروجی متد

آرایه ای از رشته ها را به عنوان خروجی برمی گرداند.

صدور خطا

در صورتی که الگوی ارسال شده به عنوان عبارت باقاعده (regex) ناصحیح یا غیرمجاز باشد، خطای PatternSyntaxException رخ می دهد.

ویرایشی که از این متد پشتیبانی می کند

این متد از ویرایش 1.4 ابزار JDK جاوا در اختیار توسعه دهندگان قرار گرفت.

مثال کاربردی از متد split() در جاوا

مثال جاری تمامی کلمات موجود در آبجکت s1 را که بر اساس فاصله (space) از هم جدا شده اند، برمی گرداند.

public class SplitExample{  
public static void main(String args[]){  
String s1="java string split method by javatpoint";  
String[] words=s1.split("\\s");//splits the string based on whitespace  
//using java foreach loop to print elements of string array  
for(String w:words){  
System.out.println(w);  
}  
}}  

خروجی:

java
string
split
method
by
javatpoint

مثال کاربردی از متد split(String regex, int limit) در جاوا

public class SplitExample2{  
public static void main(String args[]){  
String s1="welcome to split world";  
System.out.println("returning words:");  
for(String w:s1.split("\\s",0)){  
System.out.println(w);  
}  
System.out.println("returning words:");  
for(String w:s1.split("\\s",1)){  
System.out.println(w);  
}  
System.out.println("returning words:");  
for(String w:s1.split("\\s",2)){  
System.out.println(w);  
}  
}}  

خروجی:

returning words:
welcome 
to 
split 
world
returning words:
welcome to split world
returning words:
welcome 
to split world