Java StringBuilder charAt() 方法

---

---

Java 的StringBuilder charAt() 方法用于获取此序列中指定索引处的字符值。由于 StringBuilder 与 String 相同（但可修改），因此其索引方式也类似。第一个字符值位于索引 0，下一个位于索引 1，以此类推，与 String/数组索引相同。

注意 −

• 索引参数必须大于或等于 0，且小于此序列的长度。
• 如果索引指定的字符值是代理项，则返回代理项值。

语法

以下是 Java StringBuilder charAt() 方法的语法

public char charAt(int index)

参数

• index − 这是所需字符值的索引。

返回值

此方法返回指定索引处的字符值。

示例：获取给定索引处的字符

当我们将索引作为参数传递给方法时，将返回该索引处的字符。

以下示例演示了 Java StringBuilder charAt() 方法的用法。在这里，我们声明一个 StringBuilder 对象并用一系列字符初始化它。该方法采用索引作为参数来查找该索引处存在的字符。

package com.tutorialspoint;


public class StringBuilderDemo {

   public static void main(String[] args) {

      StringBuilder buff = new StringBuilder("Tutorials Point");
      System.out.println("buffer = " + buff);

      // returns the char at index 4
      System.out.println("character = " + buff.charAt(4));
   
      buff = new StringBuilder("amrood admin ");
      System.out.println("buffer = " + buff);
      
      // returns the char at index 6, whitespace gets printed here
      System.out.println("character = " + buff.charAt(6));
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

buffer = Tutorials Point
character = r
buffer = amrood admin
character =  

示例：获取给定索引处的字符

下面是另一个检索索引处字符的示例。在这里，我们执行算术加法，并将结果作为参数传递给方法。

public class StringBuilderCharAt {
   public static void main(String args[]) {

      StringBuilder sb = new StringBuilder("Tutorialspoint");

      int id1 = 6;
      int id2 = 7;

      System.out.println("The character at " + (id1 + id2) + " index is: " + sb.charAt(id1 + id2));
   }
}

输出

让我们编译并运行上面的程序，结果如下：

The character at 13 index is: t

示例：获取负索引处的字符时遇到异常

但是，当我们将负索引作为参数传递给方法时，将抛出 StringIndexOutOfBoundsException 异常。

public class StringBuilderCharAt {
   public static void main(String args[]) {

      // Creating a StringBuilder object and Initializing it
      StringBuilder sb = new StringBuilder("Tutorialspoint");

      // declare and assign the index value to an int variable
      int id = -4;

      // print the output
      System.out.println("The character at " + id + " index is: " + sb.charAt(id)); //throws exception
   }
}

异常

如果我们尝试编译并运行上面的程序，该方法将抛出 StringIndexOutOfBoundsException 异常：

Exception in thread "main" java.lang.StringIndexOutOfBoundsException: Index -4 out of bounds for length 14
        at java.base/jdk.internal.util.Preconditions$1.apply(Preconditions.java:55)
        at java.base/jdk.internal.util.Preconditions$1.apply(Preconditions.java:52)
        at java.base/jdk.internal.util.Preconditions$4.apply(Preconditions.java:213)
        at java.base/jdk.internal.util.Preconditions$4.apply(Preconditions.java:210)
        at java.base/jdk.internal.util.Preconditions.outOfBounds(Preconditions.java:98)
        at java.base/jdk.internal.util.Preconditions.outOfBoundsCheckIndex(Preconditions.java:106)
        at java.base/jdk.internal.util.Preconditions.checkIndex(Preconditions.java:302)
        at java.base/java.lang.String.checkIndex(String.java:4570)
        at java.base/java.lang.AbstractStringBuilder.charAt(AbstractStringBuilder.java:358)
        at java.base/java.lang.StringBuilder.charAt(StringBuilder.java:243)
        at StringBuilderCharAt.main(StringBuilderCharAt.java:10)

示例：使用无效索引获取字符时遇到异常

在另一种情况下，如果我们传递的索引值大于输入序列长度，该方法也会抛出 StringIndexOutOfBoundsException 异常。

public class StringBuilderCharAt {
   public static void main(String args[]) {

      // Creating a StringBuilder object and Initializing it
      StringBuilder sb = new StringBuilder("Tutorialspoint");

      // declare and assign the index value to an int variable
      int id = 15;

      // print the output
      System.out.println("The character at " + id + " index is: " + sb.charAt(id)); //throws exception
   }
}

输出

如果我们尝试编译并运行上面的程序，该方法将抛出 StringIndexOutOfBoundsException 异常：

Exception in thread "main" java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 14
        at java.base/jdk.internal.util.Preconditions$1.apply(Preconditions.java:55)
        at java.base/jdk.internal.util.Preconditions$1.apply(Preconditions.java:52)
        at java.base/jdk.internal.util.Preconditions$4.apply(Preconditions.java:213)
        at java.base/jdk.internal.util.Preconditions$4.apply(Preconditions.java:210)
        at java.base/jdk.internal.util.Preconditions.outOfBounds(Preconditions.java:98)
        at java.base/jdk.internal.util.Preconditions.outOfBoundsCheckIndex(Preconditions.java:106)
        at java.base/jdk.internal.util.Preconditions.checkIndex(Preconditions.java:302)
        at java.base/java.lang.String.checkIndex(String.java:4570)
        at java.base/java.lang.AbstractStringBuilder.charAt(AbstractStringBuilder.java:358)
        at java.base/java.lang.StringBuilder.charAt(StringBuilder.java:243)
        at StringBuilderCharAt.main(StringBuilderCharAt.java:13)