Java.lang.StringBuilder.insert() Method

---

---

Description

The java.lang.StringBuilder.insert(int offset, char c) method inserts the string representation of the char argument into this sequence.

The second argument is inserted into the contents of this sequence at the position indicated by offset. The length of this sequence increases by one.The offset argument must be greater than or equal to 0, and less than or equal to the length of this sequence.

Declaration

Following is the declaration for java.lang.StringBuilder.insert() method

public StringBuilder insert(int offset, char c)

Parameters

• offset − This is the offset.

• c − This is the char value.

Return Value

This method returns a reference to this object.

Exception

IndexOutOfBoundsException − if the offset is invalid.

Example

The following example shows the usage of java.lang.StringBuilder.insert() method.

package com.tutorialspoint;

import java.lang.*;

public class StringBuilderDemo {

   public static void main(String[] args) {
  
      StringBuilder str = new StringBuilder("Tutorial");
      System.out.println("string = " + str);

      // insert character value at offset 8
      str.insert(8, 's');

      // prints StringBuilder after insertion
      System.out.print("After insertion = ");
      System.out.println(str.toString());
   }      
}  

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

string = Tutorial
After insertion = Tutorials