The Java String class join() метод повертає рядок, об’єднаний заданим роздільником. У методі String join() роздільник копіюється для кожного елемента. Метод join() включено в рядок Java, починаючи з JDK 1.8.
У класі Java String є два типи методів join().
Підпис
Сигнатуру або синтаксис методу join() наведено нижче:
public static String join(CharSequence delimiter, CharSequence... elements) and public static String join(CharSequence delimiter, Iterable elements)
Параметри
роздільник : значення char, яке буде додано до кожного елемента
елементів : значення char, яке буде додано з роздільником
Повернення
об'єднаний рядок із роздільником
Кидки винятків
NullPointerException якщо елемент або роздільник є нульовим.
Оскільки
1.8
Внутрішнє впровадження
// type - 1 public static String join(CharSequence delimiter, CharSequence... elements) { Objects.requireNonNull(elements); Objects.requireNonNull(delimiter); StringJoiner jnr = new StringJoiner(delimiter); for (CharSequence c: elements) { jnr.add(c); } return jnr.toString(); }
// type - 2 public static String join(CharSequence delimiter, CharSequence... elements) { Objects.requireNonNull(elements); Objects.requireNonNull(delimiter); StringJoiner jnr = new StringJoiner(delimiter); for (CharSequence c: elements) { jnr.add(c); } return jnr.toString(); } public static String join(CharSequence delimiter, Iterable elements) { Objects.requireNonNull(elements); Objects.requireNonNull(delimiter); StringJoiner jnr = new StringJoiner(delimiter); for (CharSequence c: elements) { joiner.add(c); } return jnr.toString(); }
Приклад методу Java String join().
Ім'я файлу: StringJoinExample.java
public class StringJoinExample{ public static void main(String args[]){ String joinString1=String.join('-','welcome','to','javatpoint'); System.out.println(joinString1); }}Перевірте зараз
Вихід:
welcome-to-javatpoint
Приклад 2 методу Java String join().
Ми можемо використати роздільник для форматування рядка, як ми робили в прикладі нижче, щоб показати дату та час.
Ім'я файлу: StringJoinExample2.java
public class StringJoinExample2 { public static void main(String[] args) { String date = String.join('/','25','06','2018'); System.out.print(date); String time = String.join(':', '12','10','10'); System.out.println(' '+time); } }
Вихід:
25/06/2018 12:10:10
Приклад 3 методу Java String join().
У разі використання null як розділювача ми отримуємо виняток нульового покажчика. Наступний приклад підтверджує те саме.
Ім'я файлу: StringJoinExample3.java
public class StringJoinExample3 { // main method public static void main(String argvs[]) { String str = null; str = String.join(null, 'abc', 'bcd', 'apple'); System.out.println(str); } }
Вихід:
Exception in thread 'main' java.lang.NullPointerException at java.base/java.util.Objects.requireNonNull(Objects.java:221) at java.base/java.lang.String.join(String.java:2393) at StringJoinExample3.main(StringJoinExample3.java:7)
Однак, якщо елементи, які потрібно приєднати за допомогою розділювача, є нуль тоді ми отримуємо двозначність. Це тому, що існує два методи join() і нуль прийнятний для обох типів методу join(). Зверніть увагу на наступний приклад.
Ім'я файлу: StringJoinExample4.java
public class StringJoinExample4 { // main method public static void main(String argvs[]) { String str = null; str = String.join('India', null); System.out.println(str); } }
Вихід:
/StringJoinExample4.java:7: error: reference to join is ambiguous str = String.join('India', null); ^ both method join(CharSequence,CharSequence...) in String and method join(CharSequence,Iterable) in String match /StringJoinExample4.java:7: warning: non-varargs call of varargs method with inexact argument type for last parameter; str = String.join('India', null); ^ cast to CharSequence for a varargs call cast to CharSequence[] for a non-varargs call and to suppress this warning 1 error 1 warning
Приклад 4 методу Java String join().
Якщо елементи, які мають бути приєднані за допомогою роздільника, мають кілька рядків, у яких деякі з них є нульовими, тоді нульові елементи розглядаються як звичайний рядок, і ми не отримуємо винятків чи помилок. Зрозуміємо це на прикладі.
Ім'я файлу: StringJoinExample5.java
public class StringJoinExample5 { // main method public static void main(String argvs[]) { String str = null; // one of the element is null however it will be treated as normal string str = String.join('-', null, ' wake up ', ' eat ', ' write content for JTP ', ' eat ', ' sleep '); System.out.println(str); } }
Вихід:
null- wake up - eat - write content for JTP - eat - sleep