add()
متد add در ArrayList یک عضو جدید اضافه می کند. «ArrayList» یعنی لیست پویا؛ اندازه اش تغییر می کند. همچنین «نوع داده (Data Type)» یعنی جنس اطلاعات، مثل متن یا عدد.
تعریف و کاربرد متد add
طبق منبع، add() یک عضو به لیست اضافه می کند. اگر «ایندکس (Index)» بدهیم، عضو در همان جای مشخص می نشیند و بقیه یک خانه جلو می روند. اگر ایندکس ندهیم، عضو در انتهای لیست می آید.
سینتکس متد add
یکی از دو شکل زیر استفاده می شود. حرف T یعنی نوع آیتم های لیست.
public boolean add(T item)
public void add(int index, T item)
ورودی ها و خروجی ها
- item: لازم. عضوی که باید اضافه شود.
- index: اختیاری. جای قرارگیری عضو.
- خروجی بدون ایندکس: مقدار
trueیاfalseبر اساس تغییر. - خروجی با ایندکس: چیزی برنمی گرداند.
- خطا:
IndexOutOfBoundsExceptionبرای ایندکس نامعتبر.
مثال ساده: اضافه کردن چند عضو
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");
System.out.println(cars);
}
}
مثال با ایندکس مشخص
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");
cars.add(2, "Toyota");
System.out.println(cars);
}
}
گام های عملی سریع
- یک ArrayList بساز.
- چند آیتم با add() اضافه کن.
- یک مورد را با ایندکس درج کن.
نکته: ایندکس باید بین صفر و اندازه لیست باشد.
مطالعه مرتبط و لینک ها
برای دیدن همه متدها، صفحه متدهای ArrayList را ببین. همچنین برای آرایه ها، روش های آرایه ها مفید است. راهنمای آموزشی بیرونی: Java ArrayList Tutorial.
نکته: اگر «متد add ArrayList» را می خواهی یکجا، همین صفحه بهترین مرجع است. همچنین می توانی از لینک متد add در ArrayList استفاده کنی.
جمع بندی سریع
- add بدون ایندکس، انتهای لیست اضافه می کند.
- add با ایندکس، در جای مشخص درج می کند.
- خروجی بدون ایندکس، بولی برمی گرداند.
- ایندکس اشتباه، خطای محدوده می دهد.