StringBuilder sureCapacity() en Java con ejemplos

El método sureCapacity(int minimalCapacity) de la clase StringBuilder nos ayuda a garantizar que la capacidad sea al menos igual a la capacidad mínima especificada que se pasa como parámetro al método.

• Si la capacidad actual de StringBuilder es menor que el argumento minimalCapacity, se asigna una nueva array interna con mayor capacidad.
• Si el argumento de capacidad mínima es mayor que el doble de la capacidad anterior, más 2, la nueva capacidad es igual a la capacidad mínima; de lo contrario, la nueva capacidad es igual al doble de la capacidad anterior, más 2.
• Si el argumento de capacidad mínima pasado como parámetro no es positivo, este método no realiza ninguna acción.

Sintaxis:

public void ensureCapacity(int minimumCapacity)

Parámetros: este método acepta un parámetro de capacidad mínima que representa la capacidad mínima deseada que desea.

Valor devuelto: este método no devuelve nada.

Los programas a continuación demuestran el método sureCapacity() de la clase StringBuilder:

Ejemplo 1:

En este programa, el argumento de capacidad mínima, que es igual a 18, es menos del doble de la capacidad anterior, más 2, que es igual a 34, entonces la nueva capacidad es igual a 34.

// Java program to demonstrate
// the ensureCapacity() Method.
  
class GFG {
    public static void main(String[] args)
    {
        // create a StringBuilder object
        StringBuilder str = new StringBuilder();
  
        // print string capacity
        System.out.println("Before ensureCapacity "
                           + "method capacity = "
                           + str.capacity());
  
        // apply ensureCapacity()
        str.ensureCapacity(18);
  
        // print string capacity
        System.out.println("After ensureCapacity"
                           + " method capacity = "
                           + str.capacity());
    }
}

Producción:

Before ensureCapacity method capacity = 16
After ensureCapacity method capacity = 34

Ejemplo 2:

En este programa, el argumento de capacidad mínima, que es igual a 44, es mayor que el doble de la capacidad anterior, más 2, que es igual a 34, entonces la nueva capacidad es igual a 34.

// Java program to demonstrate
// the ensureCapacity() Method.
  
class GFG {
    public static void main(String[] args)
    {
  
        // create a StringBuilder object
        StringBuilder str = new StringBuilder();
  
        // print string capacity
        System.out.println("Before ensureCapacity"
                           + " method capacity = "
                           + str.capacity());
  
        // apply ensureCapacity()
        str.ensureCapacity(44);
  
        // print string capacity
        System.out.println("After ensureCapacity"
                           + " method capacity = "
                           + str.capacity());
    }
}

Producción:

Before ensureCapacity method capacity = 16
After ensureCapacity method capacity = 44

Referencia:
https://docs.oracle.com/javase/10/docs/api/java/lang/StringBuilder.html#ensureCapacity(int)