addAll()
متد addAll در ArrayList همه آیتم های یک مجموعه را اضافه می کند. «مجموعه (Collection)» یعنی ظرفی از چند آیتم، مثل لیست همکلاسی ها.
تعریف و کاربرد
طبق منبع، addAll() همه آیتم های یک Collection را به لیست می افزاید. اگر ایندکس بدهی، آیتم ها از همان جای مشخص وارد می شوند. در غیر این صورت، انتهای لیست اضافه می شوند.
سینتکس متد addAll
یکی از این دو امضا استفاده می شود. حرف T یعنی نوع آیتم ها.
public boolean addAll(Collection<T> items)
public boolean addAll(int index, Collection<T> items)
مثال 1: افزودن یک لیست به لیست دیگر
import java.util.ArrayList;
public class Main {
public static void main(String[] args) {
ArrayList<String> cars = new ArrayList<String>();
cars.add("Volvo");
cars.add("BMW");
cars.add("Ford");
cars.add("Mazda");
ArrayList<String> brands = new ArrayList<String>();
brands.add("Microsoft");
brands.add("W3Schools");
brands.add("Apple");
brands.addAll(cars);
System.out.println(brands);
}
}
مثال 2: افزودن از یک ایندکس مشخص
import java.util.ArrayList;
public class Main {
public static void main(String[] args) {
ArrayList<String> cars = new ArrayList<String>();
cars.add("Volvo");
cars.add("BMW");
cars.add("Ford");
cars.add("Mazda");
ArrayList<String> brands = new ArrayList<String>();
brands.add("Microsoft");
brands.add("W3Schools");
brands.add("Apple");
brands.addAll(1, cars);
System.out.println(brands);
}
}
ورودی ها، خروجی و خطاها
- items: لازم. مجموعه آیتم ها برای افزودن.
- index: اختیاری. جای شروع درج آیتم ها.
- خروجی:
trueاگر لیست تغییر کند، وگرنهfalse. - خطا:
IndexOutOfBoundsExceptionبرای ایندکس نامعتبر. - خطا:
NullPointerExceptionاگر مجموعه تهی باشد.
نکته: مثل چسباندن دو برگه است؛ یا ته دفتر، یا وسط.
گام های عملی سریع
- دو ArrayList بساز.
- آیتم ها را پر کن.
- با addAll() یکی را به دیگری بچسبان.
مطالعه مرتبط و لینک ها
برای دیدن همه متدها، صفحه روش های ArrayList را ببین. برای آرایه ها هم روش های آرایه ها مفید است. همچنین صفحه آموزشی بیرونی: Java ArrayList Tutorial.
هشدار: اگر مجموعه null باشد، برنامه خطا می دهد. همیشه بررسی کن.
جمع بندی سریع
- addAll کل یک مجموعه را می افزاید.
- با ایندکس، از جای مشخص درج می شود.
- خروجی می گوید لیست تغییر کرده است یا نه.
- null باعث
NullPointerExceptionمی شود.