Java List sublist() Method

The sublist() method of List Interface returns a view of the portion of this list between the inclusive and exclusive parameters. This method eliminates the need for explicit range operations.

Syntax

Parameters

The parameters 'fromIndex' and 'toIndex' represent the low and high endpoint of the subList.

Return

The subList() method returns a view of the specified range within this list.

Throws:

IndexOutOfBoundsException- This exception will throw for an illegal endpoint index value, i.e, fromIndex < 0 or toIndex> size or fromIndex > toIndex.

Example 1

import java.util.LinkedList;
import java.util.List;
public class JavaListSubListExample1 {
public static void main(String[] args) {
int fromIndex=2;
int toIndex=7;
        List<Integer> list= new LinkedList<>();
for (int i=1;i<=10;i++){
list.add(i);
        }
System.out.println("List : "+list);
//it will return the elements present from index 2 to elements at index 7
list.subList(fromIndex,toIndex);
System.out.println("Elements from 2 index position to 7 index position : "+list.subList(2,7));
    }
}

Test it Now

Output:

List : [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
Elements from 2 index position to 7 index position : [3, 4, 5, 6, 7]

Example 2

import java.util.LinkedList;
import java.util.List;
public class JavaListSubListExample_2 {
public static void main(String[] args) {
        List<Character> list= new LinkedList<>();
for (char ch='a';ch<='z';ch++){
list.add(ch);
        }
System.out.println("Total alphabets : "+list.size());
//if fromIndex>toIndex it will throw an exception
System.out.println("List : "+list.subList(18,12));
    }
}

Test it Now

Output:

Total alphabets : 26
Exception in thread "main" java.lang.IllegalArgumentException: fromIndex(18) >toIndex(12)
	atjava.util.SubList.<init>(AbstractList.java:624)
	atjava.util.AbstractList.subList(AbstractList.java:484)
	at com.javaTpoint.JavaListSubListExample2.main(JavaListSubListExample2.java:12)

Example 3

import java.util.LinkedList;
import java.util.List;
public class JavaListSubListExample_3 {
public static void main(String[] args) {
        List<Character> list= new LinkedList<>();
for (char ch='a';ch<='z';ch++){
list.add(ch);
        }
System.out.println("Total alphabets : "+list.size());
//if fromIndex<-1 || toIndex< -1 it will throw an exception
System.out.println("List : "+list.subList(-1,-1));
    }
}

Test it Now

Output:

Total alphabets : 26
Exception in thread "main" java.lang.IndexOutOfBoundsException: fromIndex = -1
	atjava.util.SubList.<init>(AbstractList.java:620)
	atjava.util.AbstractList.subList(AbstractList.java:484)
	at com.javaTpoint.JavaListSubListExample3.main(JavaListSubListExample3.java:13)

Next TopicJava List

← prev next →