Java String subSequence()

This article will teach you how to get a subsequence from a String. This looks similar to the Java String substring() method, but the substring method returns a new String while the subSequence method returns CharSequence rather than String.

The subSequence() method is implemented in the String class because Java 1.4 introduced the CharSequence interface, and String implements this interface. This method internally invokes the substring() method.

Post On:	String subSequence() Method in Java
Post Type:	Java Tutorials
Published On:	www.softwaretestingo.com
Applicable For:	Freshers & Experience
Get Updates:	SoftwareTestingo Telegram Group

In this blog post, we will learn how to use String subSequence in Java Programming language with an example.

Syntax:

The syntax of the subSequence() Method is:

// It will return Character Sequence 
public CharSequence subSequence(int Startig_index, int End_index); 

//In order to use in program
String_Object.subSequence(int Startig_index, int End_Index)

Here the subSequence() method takes two input parameters which should be an integer value. The First parameter informs where the extraction will start, and the second parameter informs where the extraction will end.

And the String.subSequence method will return the character sequence starting from the Starting_index up to End_index but not included.

public CharSequence subSequence(int beginIndex, int endIndex) 
{
    return this.substring(beginIndex, endIndex);
}

Program:

Example Of Java String subSequence(): The code snippet below demonstrates how to use the subSequence() method. This method returns CharSequence from a string.

Program: Write a Java program to retrieve Substring using subSequence().

package com.SoftwareTestingo.JavaBasics;
public class SubSequenceExample 
{
	public static void main(String[] args) 
	{
		String str = "www.SoftwareTestingo.com";
		System.out.println("Last 4 char String: " + str.subSequence(str.length() - 4, str.length()));
		System.out.println("First 4 char String: " + str.subSequence(0, 4));
		System.out.println("website name: " + str.subSequence(4, 20));
		// substring vs subSequence
		//When you are compare with == its comparing Hashcode which is different 
		System.out.println("substring == subSequence ? " + (str.substring(4, 14) == str.subSequence(4, 14)));
		//When you compare with equals(), its comparing value
		System.out.println("substring equals subSequence ? " + (str.substring(4, 14).equals(str.subSequence(4, 14))));
	}
}

Output:

Last 4 char String: .com
First 4 char String: www.
website name: SoftwareTestingo
substring == subSequence ? false
substring equals subSequence ? true

String subSequence() With Negative Example: In the below example, we will try to execute by entering the negative value in the index position.

package com.SoftwareTestingO.Java.basics;
public class SubSequenceExample2 
{
	public static void main(String[] args) 
	{
		String stringObject = "This example is with negative index";

		CharSequence output = stringObject.subSequence(-10, stringObject.length());
		System.out.println(output);
	}
}

Output:

Exception in thread "main" java.lang.StringIndexOutOfBoundsException: begin -10, end 35, length 35
	at java.base/java.lang.String.checkBoundsBeginEnd(String.java:4604)
	at java.base/java.lang.String.substring(String.java:2707)
	at java.base/java.lang.String.subSequence(String.java:2745)
	at com.softwaretestingo.string.SubSequenceExample2.main(SubSequenceExample2.java:8)

Final Words:

We hope that you now have a clear understanding of the use of subSequence() in Java. If you still have any questions or need further clarification, we encourage you to ask us in the comment section below. Our team is here to assist you and provide any additional information you may require. Your feedback and engagement are valuable to us, so please don’t hesitate to reach out.