Java.lang.StringBuilder.insert() Method

Advertisements


Description

The java.lang.StringBuilder.insert(int offset, char[] str) method inserts the string representation of the char array argument into this sequence.
The characters of the array argument are inserted into the contents of this sequence at the position indicated by offset. The length of this sequence increases by the length of the argument.

Declaration

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

public StringBuilder insert(int offset, char[] str)

Parameters

  • offset -- This is the offset.

  • str -- This is the character array.

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.StringBuilder.insert() method.

package com.tutorialspoint;

import java.lang.*;

public class StringBuilderDemo {

  public static void main(String[] args) {
  
    StringBuilder str = new StringBuilder("tutorials website");
    System.out.println("string = " + str);
        
    // character array to be inserted
    char cArr[] = { 'p', 'o', 'i', 'n', 't' };
    // insert character array at offset 9
    str.insert(9, cArr);
        
    // 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 website
After insertion = tutorialspoint website



Advertisements
Advertisements