freeCodeCamp/guide/english/java/arraylist/index.md

126 lines
4.4 KiB
Markdown

---
title: ArrayList
---
# ArrayList
ArrayList is a part of something called the *Collection framework*.
The *Collection framework* consists of all interfaces and classes that can hold a set of values (similar to [arrays](https://docs.oracle.com/javase/tutorial/java/nutsandbolts/arrays.html)). **ArrayList** is a class that is in this hierarchy and known as a _**Collection object**_. It implements the *List* interface which in turn implements the *Collection* interface. This *Collection* interface can be found in the `java.util` package. You will need to import this package.
```java
import java.util.ArrayList; // is more efficient than importing all of java.util
```
Always import the most specific package in order to save memory size and performance time.
`ArrayList` is a class that is used to create dynamic arrays. It is slower than regular arrays but allows for a lot of manipulation. It should be initialized to have a specific size or it will have the default size of 10 units.
```java
ArrayList<String> names = new ArrayList<>();
ArrayList<Integer> ages = new ArrayList<>(5);
```
In the above snippet, the angle breackets `<>` take a generic data type as argument specifying data type of the elements in the ArrayList. The first ArrayList `names` is specified as containing *String* elements. Thus, it will only be allowed to contain String elements. Its size is not specified so it will have a default size of 10. The second ArrayList `ages` has specified that it will only hold integers. But ArrayList cannot hold primitives, it only holds objects. Thus to make it store integers, floats, etc., we can use wrapper classes. `names` will have a specified size of 5.
Since ArrayList implements *List*, an ArrayList can be created using the following syntax:
```java
List<Integer> students = new ArrayList<>();
```
An ArrayList is dynamic, meaning it will grow in size if required and similarly shrink in size if elements are deleted from it. This is what makes it more flexible than normal arrays.
**Add elements to the list**
```java
variable.add(String e);
variable.add(int index, String element);
```
**Clear/Delete all elements from the list**
```java
variable.clear();
```
**Delete element at specified index from the list**
```java
variable_name.remove(index_number);
```
**Access element at specified index**
```java
variable_name.get(index_number);
```
**Modify/update element at specified index**
```java
variable_name.set(index_number, element);
```
**Get the size of the list**
```java
variable_name.size();
```
**Get a sublist of the list**
```java
variable_name.subList(int fromIndex, int toIndex);
```
**Reverse elements in list**
```java
import java.util.Collections; // package
Collections.reverse(variable_name);
```
**Sort elements in ascending order**
```java
Collections.sort(variable_name);
```
**Sort elements in descending order**
```java
Collections.sort(variable_name, Collections.reverseOrder());
```
**Creating Array from ArrayList**
```java
Object[] arr = variable_name.toArray(new Object[variable_name.size()]);
```
**Creating ArrayList from Array**
```java
for(Object obj : arr) {
variable_name.add(obj);
}
```
An ArrayList allows us to randomly access elements. ArrayList is similar to *Vector* in a lot of ways, but it is faster than Vectors. The main thing to note is that - Vectors are faster than arrays but ArrayLists are not.
So when it comes down to choosing between the two - if speed is critical then Vectors should be considered, otherwise ArrayLists are better when it comes to storing large number of elements and accessing them efficiently.
## Basic Big O for ArrayList Methods:
`.get(int index)`
- O(1). This will always be constant time.
`.add(E ele)`
- O(1). We are only adding an element to the END of the list.
`.add(int ind, E ele)`
- O(n). Because of the way an ArrayList is implemented, we must do shifting which requires O(n) time on average.
`.remove(int ind)`
- O(n). For the same reason as above. The elements must be shifted after removal.
It is important to understand the Big O for methods of data structures. This way, you can choose the most efficient data structure for your program.
#### More Information
- [ArrayList Documentation](https://docs.oracle.com/javase/8/docs/api/java/util/ArrayList.html)