Java.lang.StringBuffer.insert() Method

---

---

Description

The java.lang.StringBuffer.insert(int offset, String str) method inserts the string into this character sequence.

The characters of the String argument are inserted, in order, into this sequence at the indicated offset, moving up any characters originally above that position and increasing the length of this sequence by the length of the argument.

Declaration

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

public StringBuffer insert(int offset, String str)

Parameters

• offset − This is the offset.

• str − This is the value of string.

Return Value

This method returns a reference to this object.

Exception

StringIndexOutOfBoundsException − if the offset is invalid.

Example

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

package com.tutorialspoint;

import java.lang.*;

public class StringBufferDemo {

   public static void main(String[] args) {
  
      StringBuffer buff = new StringBuffer("tutorials website");
      System.out.println("buffer = " + buff);

      // insert string value at offset 9
      buff.insert(9,"point");

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

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

buffer = tutorials website
After insertion = tutorialspoint website