Java.lang.StringBuilder.insert() Method



Description

The java.lang.StringBuilder.insert(int dstOffset, CharSequence s) method inserts the specified CharSequence into this sequence.

The characters of the CharSequence 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 s.

Declaration

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

public StringBuilder insert(int dstOffset, CharSequence s)

Parameters

  • dstOffset − This is the offset.

  • s − This is the sequence to be inserted.

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("tutorials");
      System.out.println("string = " + str);

      CharSequence cSeq = "point";
      
      // insert CharSequence at offset 9
      str.insert(9, cSeq);

      // 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 = tutorials
After insertion = tutorialspoint
java_lang_stringbuilder.htm
Advertisements