Java Vector subList() Method

---

---

Description

The Java Vector subList() method returns a view of the portion of this list using the fromIndex(inclusive), and toIndex(exclusive). If fromIndex and toIndex are equal, it will return empty list. Any non-structural changes in the returned list are reflected in the original list as well, and vice-versa. The returned list supports list operations as well.

Declaration

Following is the declaration for java.util.Vector.subList() method

 public List<E> subList(int fromIndex, int toIndex) 

Parameters

fromIndex − The index of the start element (inclusive).

toIndex − The index of the end element (exclusive) .

Return Value

This method returns a view of the specified range within this list.

Exception

IndexOutOfBoundsException − if an endpoint index value is out of range (fromIndex < 0 || toIndex > size).

IllegalArgumentException − if the endpoint indices are out of order (fromIndex > toIndex).

Getting sublist from a Vector of Integer Example

The following example shows the usage of Java Vector subList() method. We're creating a Vector of Integers. We're adding couple of Integers to the Vector object using add() method calls per element and using subList() method, we're getting a portion of the list and printing that portion in the end.

 package com.tutorialspoint; import java.util.Vector; public class VectorDemo { public static void main(String[] args) { // create an empty vector Vector<Integer> vector = new Vector<>(); // use add() method to add elements in the vector vector.add(0); vector.add(1); vector.add(2); vector.add(3); vector.add(4); vector.add(5); vector.add(6); // get and print a sublist System.out.println(vector.subList(1,3)); } } 

Output

Let us compile and run the above program, this will produce the following result −

 [1, 2] 

Getting sublist from a Vector of String Example

The following example shows the usage of Java Vector subList() method. We're creating a Vector of Strings. We're adding couple of Strings to the Vector object using add() method calls per element and using subList() method, we're getting a portion of the list and printing that portion in the end.

 package com.tutorialspoint; import java.util.Vector; public class VectorDemo { public static void main(String[] args) { // create an empty vector Vector<String> vector = new Vector<>(); // use add() method to add elements in the vector vector.add("A"); vector.add("B"); vector.add("C"); vector.add("D"); vector.add("E"); vector.add("F"); // get and print a sublist System.out.println(vector.subList(1,3)); } } 

Output

Let us compile and run the above program, this will produce the following result −

 [B, C] 

Getting sublist from a Vector of Object Example

The following example shows the usage of Java Vector subList() method. We're creating a Vector of Student objects. We're adding couple of Student objects to the Vector object using add() method calls per element and using subList() method, we're getting a portion of the list and printing that portion in the end.

 package com.tutorialspoint; import java.util.Vector; public class VectorDemo { public static void main(String[] args) { // create an empty vector Vector<Student> vector = new Vector<>(); // use add() method to add elements in the vector vector.add(new Student(1, "Julie")); vector.add(new Student(2, "Robert")); vector.add(new Student(3, "Adam")); // get and print a sublist System.out.println(vector.subList(1,3)); } } class Student { int rollNo; String name; Student(int rollNo, String name){ this.rollNo = rollNo; this.name = name; } @Override public String toString() { return "[ " + this.rollNo + ", " + this.name + " ]"; } @Override public boolean equals(Object obj) { Student s = (Student)obj; return this.rollNo == s.rollNo && this.name.equalsIgnoreCase(s.name); } } 

Output

Let us compile and run the above program, this will produce the following result −

 [[ 2, Robert ], [ 3, Adam ]]