Java.lang.String.replace() Method



The java.lang.String.replace(CharSequence target, CharSequence replacement) method replaces each substring of this string that matches the literal target sequence with the specified literal replacement sequence. The replacement proceeds from the beginning of the string to the end −

Example: replacing "cc" with "b" in the string "ccc" will result in "bc" rather than "cb".


Following is the declaration for java.lang.String.replace() method

public String replace(CharSequence target, CharSequence replacement)


  • target − This is the sequence of char values to be replaced.

  • replacement − This is the replacement sequence of char values.

Return Value

This method returns the resulting string.


NullPointerException − if target or replacement is null.


The following example shows the usage of java.lang.String.replace() method.

package com.tutorialspoint;

import java.lang.*;

public class StringDemo {

   public static void main(String[] args) {

      String str = "aacdeaa";
      System.out.println("string = " + str);

      CharSequence s1 = "cde";
      CharSequence s2 = "ghi";
      // replace sequence s1 with s2
      String replaceStr = str.replace(s1, s2);

      // prints the string after replacement
      System.out.println("new string = " + replaceStr);

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

string = aacdeaa
new string = aaghiaa