.capacity()

The .capacity() method returns the current space available for characters in the StringBuilder, whereas .length() returns the number of characters actually in use.

Syntax

myStringBuilder.capacity()

The .capacity() method takes no arguments.

Example

The following example creates a StringBuilder with a specified String, then displays the capacity of the StringBuilder before and after using the .delete() method to change its contents:

import java.util.*;

public class Example {
  public static void main(String[] args)
  {
    StringBuilder str = new StringBuilder("Hello World!");
    System.out.println(str.toString());
    System.out.println(str.capacity());
    str.delete(0,6);
    System.out.println(str.toString());
    System.out.println(str.capacity());
  }
}

This produces the following output:

Hello World!
28
World!
28