CKTIS / Java
StringBuilder: capacidad inicial, longitud y crecimiento del búfer
Distingue la capacidad del búfer de la longitud del texto, encadena llamadas a append y comprueba que el búfer crece sin depender de una capacidad final concreta.
Versión: Java SE 21
Sintaxis
java.lang.StringBuilder
public StringBuilder()
public StringBuilder(int capacity)
public StringBuilder append(String str)
public StringBuilder append(int i)
public String toString()
public int capacity()
public int length()En Java SE 21, java.lang.StringBuilder almacena texto mutable. StringBuilder() crea un objeto vacío con capacidad 16; StringBuilder(int) lo crea vacío con exactamente la capacidad indicada. Ambos empiezan con longitud 0. Una capacidad negativa lanza NegativeArraySizeException.
length() cuenta las unidades de código UTF-16 (char) almacenadas, no los puntos de código Unicode. capacity() indica cuántas unidades caben en total en el búfer actual, incluidas las que ya están almacenadas. No indica ni el espacio libre ni el tamaño en bytes. Si al añadir texto se supera esa capacidad, el búfer crece automáticamente.
append(String) añade texto al final; un argumento de tipo String cuyo valor sea null añade "null". append(int) añade la representación decimal del entero, no el carácter con ese código. Ambas sobrecargas modifican y devuelven el mismo objeto, lo que permite encadenar llamadas.
toString() devuelve un String inmutable con el texto actual. Los cambios posteriores en el builder no afectan al resultado. Si puedes estimar la longitud final, elegir la capacidad inicial puede reducir las reasignaciones de memoria; esa capacidad no es un límite de longitud.
Ejemplos
public class Main {
public static void main(String[] args) {
StringBuilder defaults = new StringBuilder();
StringBuilder text = new StringBuilder(4);
System.out.println("default: capacity=" + defaults.capacity()
+ ", length=" + defaults.length());
System.out.println("initial: capacity=" + text.capacity()
+ ", length=" + text.length());
text.append("ID=").append(123);
String result = text.toString();
int length = text.length();
if (text.capacity() < length) {
throw new AssertionError("capacity < length");
}
System.out.println("text=" + result);
System.out.println("length=" + length);
System.out.println("capacity >= length: true");
}
}Resultado
default: capacity=16, length=0 initial: capacity=4, length=0 text=ID=123 length=6 capacity >= length: true
Ambos objetos empiezan con longitud 0. El segundo tiene una capacidad inicial de exactamente 4. La cadena añade `ID=` y `123`, y `toString()` devuelve `ID=123`, de longitud 6. El búfer tuvo que crecer; la comprobación solo exige `capacity() >= length()` y no presupone una capacidad concreta tras el crecimiento.
Lecciones relacionadas
- Java · Lección 49 · Avanzado · Versión: 2