Java String substring() with examples

This method returns a string which is a subset/portion of another string.

There are two variations of this method.

public String substring(int beginIndex)


public String substring(int beginIndex, int endIndex)


public String substring(int beginIndex)



This method returns a string from beginIndex to the end of the string.

NB:The index starts at 0.


String str = "whitepiano";



The above code outputs 





If the beginIndex is larger than the String size or less than 0(negative),then java.lang.StringIndexOutOfBoundsException will be thrown.


Calling the above code with beginIndex as 0 returns the entire string i.e

String str = "whitepiano";






public String substring(int beginIndex,  int endIndex)

This method returns a string formed from beginIndex(inclusive) to endIndex-1(endIndex is exclusive)

It will throw java.lang.StringIndexOutOfBoundsException if beginIndex is negative,endIndex is greater than string length or beginIndex is larger than endIndex.


String str = "whitepiano";


The above code will output  itep



Some common use cases of String substring method.

1.Suffix and Prefix extraction e.g getting the currency of amount to process from a string containing both currency code and amount e.g USD300.21 -> "USD300.21".substring(3) will return the amount 300.21.This is assuming that currency code will always be 3 characters long.

About the Author - John Kyalo Mbindyo(Bsc Computer Science) is a Senior Application Developer currently working at NCBA Bank Group,Nairobi- Kenya.He is passionate about making programming tutorials and sharing his knowledge with other software engineers across the globe. You can learn more about him and follow him on  Github.