原文：http://zetcode.com/java/stringbuilder/

Java StringBuilder教程显示了如何在 Java 中使用StringBuilder。 Java String对象是不可变的。 只能创建原始字符串的修饰副本。 当我们需要就地修改字符串时，可以使用StringBuilder。

StringBuilder

StringBuilder是可变的字符序列。 当我们想就地修改 Java 字符串时，使用StringBuilder。 StringBuffer是类似于StringBuilder的线程安全等效项。

StringBuilder具有允许修改字符串的方法，例如append()，insert()或replace()。

Java StringBuilder构造器

StringBuilder具有四个构造器：

构造器 描述
StringBuilder() 创建一个初始容量为 16 个字符的空字符串构建器
StringBuilder(CharSequence seq) 从CharSequence创建一个字符串生成器
StringBuilder(int capcity) 用指定的首字母创建一个空的字符串生成器
StringBuilder(String str) 从指定的字符串创建字符串生成器

Java StringBuilder是可变的

Java String是不可变的，而StringBuilder是可变的。

MutableImmutableEx.java

  1. package com.zetcode;
  3. public class MutableImmutableEx {
  5.     public static void main(String[] args) {
  7.         var word = "rock";
  8.         var word2 = word.replace('r', 'd');
  10.         System.out.println(word2);
  12.         var builder = new StringBuilder("rock");
  13.         builder.replace(0, 1, "d");
  15.         System.out.println(builder);
  16.     }
  17. }

该示例演示了String和StringBuilder之间的主要区别。

  1. var word2 = word.replace('r', 'd');

Java String具有replace()方法，但它不会修改原始字符串。 而是创建修改后的副本。

  1. var builder = new StringBuilder("rock");
  2. builder.replace(0, 1, "d");

另一方面，StringBuilder替换字符串。

  1. dock
  2. dock

这是输出。

Java StringBuilder附加方法

StringBuilder包含几个重载append()方法，它们在字符串的末尾添加一个值。

StringBuilderEx.java

  1. package com.zetcode;
  3. import java.util.stream.LongStream;
  5. public class StringBuilderAppendEx {
  7.     private final static long MAX_VAL = 500;
  9.     public static void main(String[] args) {
  11.         var builder = new StringBuilder();
  13.         var sum = LongStream.rangeClosed(0, MAX_VAL).sum();
  15.         LongStream.rangeClosed(1, MAX_VAL).forEach(e -> {
  17.             builder.append(e);
  19.             if (e % 10 == 0) {
  20.                 builder.append("\n");
  21.             }
  23.             if (e < MAX_VAL) {
  24.                 builder.append(" + ");
  25.             } else {
  26.                 builder.append(" = ");
  27.             }
  28.         });
  30.         builder.append(sum);
  32.         System.out.println(builder);
  33.     }
  34. }

该示例从数百个小字符串中构建一个大字符串。 字符串的格式如下：1 + 2 + 3 + ... + MAX_VAL = SUM。

  1. var builder = new StringBuilder();

空的StringBuilder被创建。

  1. LongStream.rangeClosed(1, MAX_VAL).forEach(e -> {

将创建一个值范围1..MAX_VAL。 我们使用forEach()方法迭代这些值。

  1. builder.append(e);

我们使用append()方法将当前值附加到字符串生成器。

  1. if (e % 10 == 0) {
  2.     builder.append("\n");
  3. }

为了使输出适合屏幕，我们在每十个值之后添加一个换行符。

  1. if (e < MAX_VAL) {
  2.     builder.append(" + ");
  3. } else {
  4.     builder.append(" = ");
  5. }

在这些值之间，我们添加+或"="字符。

  1. builder.append(sum);

在字符串的末尾，我们添加值的总和。

  1. System.out.println(builder);

最后，字符串被打印到控制台。

StringBuilder插入方法

insert()方法用于将字符串插入构建器的指定位置。

StringBuilderInsertEx.java

  1. package com.zetcode;
  3. public class StringBuilderInsertEx {
  5.     public static void main(String[] args) {
  7.         var sentence = "There is a red fox in the forest.";
  8.         var builder = new StringBuilder(sentence);
  10.         builder.insert(19, "and a wolf ");
  12.         System.out.println(builder);
  13.     }
  14. }

该示例使用insert()方法将字符串插入句子中。

  1. There is a red fox and a wolf in the forest.

我们创建了这句话。

获取子字符串的索引

indexOf()方法返回第一次出现的子字符串，而lastIndexOf()方法返回最后出现的子字符串。

StringBuilderIndexesEx.java

  1. package com.zetcode;
  3. public class StringBuilderIndexesEx {
  5.     public static void main(String[] args) {
  7.         var builder = new StringBuilder();
  9.         builder.append("There is a wolf in the forest. ");
  10.         builder.append("The wolf appeared very old. ");
  11.         builder.append("I never saw a wild wolf in my life.");
  13.         var term = "wolf";
  15.         int firstIdx = builder.indexOf(term);
  16.         int firstIdx2 = builder.indexOf(term, 15);
  18.         System.out.format("First occurrence of %s %d%n", term, firstIdx);
  19.         System.out.format("First occurrence of %s %d%n", term, firstIdx2);
  21.         int lastIdx = builder.lastIndexOf(term);
  22.         int lastIdx2 = builder.lastIndexOf(term, 15);
  24.         System.out.format("Last occurrence of %s %d%n", term, lastIdx);
  25.         System.out.format("Last occurrence of %s %d%n", term, lastIdx2);
  27.         System.out.println(builder);
  28.     }
  29. }

该示例使用indexOf()和lastIndexOf()方法来获取"wolf"子字符串的索引。

  1. var builder = new StringBuilder(); 
  3. builder.append("There is a wolf in the forest. ");
  4. builder.append("The wolf appeared very old. ");
  5. builder.append("I never saw a wild wolf in my life.");

我们使用append()方法创建一个字符串生成器。

  1. int firstIdx = builder.indexOf(term);

我们从生成器中首次获得"wolf"一词。

  1. int firstIdx2 = builder.indexOf(term, 15);

从索引 15 开始，我们从构建器中首次获得"wolf"术语。

  1. int lastIdx = builder.lastIndexOf(term);
  2. int lastIdx2 = builder.lastIndexOf(term, 15);

同样，我们获得"wolf"子字符串的最后一次出现。

  1. First occurrence of wolf 11
  2. First occurrence of wolf 35
  3. Last occurrence of wolf 78
  4. Last occurrence of wolf 11
  5. There is a wolf in the forest. The wolf appeared very old. I never saw 
  6. a wild wolf in my life.

这是输出。

StringBuilder替换方法

replace()方法用指定的新字符串替换字符串生成器中的子字符串。

StringBuilderReplaceEx.java

  1. package com.zetcode;
  3. public class StringBuilderReplaceEx {
  5.     public static void main(String[] args) {
  7.         var sentence = "I saw a red fox running into the forest.";
  8.         var builder = new StringBuilder(sentence);
  10.         var term = "fox";
  11.         var newterm = "dog";
  13.         int idx = builder.indexOf(term);
  14.         int len = term.length();
  16.         builder.replace(idx, idx + len, newterm);
  18.         System.out.println(builder);
  19.     }
  20. }

该示例将"fox"子字符串替换为"dog"字符串。

  1. int idx = builder.indexOf(term);

我们找到要替换的子字符串的开始索引。

  1. int len = term.length();

在我们的操作中，我们需要知道子字符串的长度。

  1. builder.replace(idx, idx + len, newterm);

我们称为replace()方法。 第一个参数是要删除的子字符串的开始索引，第二个参数是要删除的子字符串的结束索引。 第三个参数是新字符串。

StringBuilder删除字符

在字符串构建器中，有两种删除字符的方法。

StringBuilderRemoveEx.java

  1. package com.zetcode;
  3. public class StringBuilderRemoveEx {
  5.     public static void main(String[] args) {
  7.         var sentence = "There is a red fox in the forest.";
  8.         var builder = new StringBuilder(sentence);
  10.         builder.delete(11, 14);
  11.         System.out.println(builder);
  13.         builder.deleteCharAt(11);
  14.         System.out.println(builder);
  15.     }
  16. }

该示例从字符串中删除一些字符。

  1. builder.delete(11, 14);

使用delete()方法，我们删除了由索引指定的子字符串。

  1. builder.deleteCharAt(11);

使用delete()方法，我们删除一个字符； 在我们的情况下，它是多余的空格字符。

  1. There is a  fox in the forest.
  2. There is a fox in the forest.

这是输出。

StringBuilder子字符串

使用substring()方法可以从字符串返回子字符串。

StringBuilderSubstringsEx.java

  1. package com.zetcode;
  3. public class StringBuilderSubstringsEx {
  5.     public static void main(String[] args) {
  7.         var sentence = "There is a red fox in the forest.";
  8.         var builder = new StringBuilder(sentence);
  10.         var word = builder.substring(15, 18);
  11.         System.out.println(word);
  13.         var sbstr = builder.substring(15);
  14.         System.out.println(sbstr);
  15.     }
  16. }

在示例中，我们检索了两个子字符串。

  1. var word = builder.substring(15, 18);

该行检索起始索引为 15 且终止索引为 18 的子字符串。

  1. var sbstr = builder.substring(15);

在这里，我们检索从索引 15 到句子结尾的子字符串。

  1. fox
  2. fox in the forest.

这是输出。

在本教程中，我们使用了 Java StringBuilder。 您可能也对相关教程感兴趣： Java 教程， Java 拆分字符串教程， Java 中的HashMap迭代， Java ArrayList教程 ， Java HashSet教程， Java NumberFormat教程， Java8 forEach教程，读取 Java 文本文件和用 Java 读取和编写 ICO 图像。