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