Java.lang.StringBuilder.insert() 方法

描述

java.lang.StringBuilder.insert(int dstOffset, CharSequence s, int start, int end) 方法将指定 CharSequence 的子序列插入到此序列中。

由 start 和 end 指定的参数 s 的子序列按顺序插入到此序列中指定目标偏移量处，向上移动任何 最初高于该位置的字符。 这个序列的长度增加了end - start。它包括一些重要的点 −

• dstOffset 参数必须大于或等于 0，并且小于或等于该序列的长度。
• start 参数必须是非负数，并且不大于 end。
• end参数必须大于等于start，小于等于s的长度。

声明

以下是 java.lang.StringBuilder.insert() 方法的声明。

public StringBuilder insert(int dstOffset, CharSequence s, int start, int end)

参数

• dstOffset − 这是偏移量。

• s − 这是要插入的序列。

• start − 这是要插入的子序列的起始索引。

• end − 这是要插入的子序列的结束索引。

返回值

此方法返回对该对象的引用。

异常

IndexOutOfBoundsException − 如果 dstOffset 为负数或大于 this.length()，或者 start 或 end 为负数，或者 start 大于 end 或 end 大于 s.length()。

示例

下面的例子展示了 java.lang.StringBuilder.insert() 方法的使用。

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 = "collection";
      /* insert CharSequence at offset 8 with start index 0 and 
         end index 10 */
      str.insert(8, cSeq, 0, 10);

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

让我们编译并运行上面的程序，这将产生下面的结果 −

string = tutorials
After insertion = tutorialcollections