The subList() method of Java.util.Stack class is used to return a view of the portion of this Stack between the specified fromIndex, inclusive, and toIndex, exclusive. (If fromIndex and toIndex are equal, the returned Stack is empty.)
The returned Stack is backed by this Stack, so non-structural changes in the returned Stack are reflected in this Stack, and vice-versa. The returned Stack supports all of the optional Stack operations.
public Stack subList(int fromIndex, int toIndex)
Parameters: This method takes the following argument as a parameter.
- fromIndex – low endpoint (inclusive) of the subList
- toIndex – high endpoint (exclusive) of the subList
Returns Value: This method returns a view of the specified range within this Stack.
Exception: This method throws the following Exception.
- IndexOutOfBoundsException – if an endpoint index value is out of range (fromIndex size)
- IllegalArgumentException – if the endpoint indices are out of order (fromIndex > toIndex)
Below are the examples to illustrate the subList() method.
Original stack: [A, B, C, D, E] SubStack of stack: [C, D]
Example 2: For IndexOutOfBoundsException
Original stack: [A, B, C, D, E] End index value is out of range java.lang.IndexOutOfBoundsException: toIndex = 7
Example 3: For IllegalArgumentException
Original stack: [A, B, C, D, E] Endpoint indices are out of order (fromIndex > toIndex) java.lang.IllegalArgumentException: fromIndex(7) > toIndex(2)
Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready.