Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

StringBuilder: un búfer de texto modificable

StringBuilder permite crear y modificar texto de forma gradual. Aprende la diferencia entre longitud y capacidad, y qué ocurre cuando setLength trunca o amplía la secuencia.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

new StringBuilder();
new StringBuilder(8);
int length();
int capacity();
void setLength(int newLength);

java.lang.StringBuilder es una secuencia de caracteres modificable. append añade contenido y toString() crea el String resultante. La clase no garantiza la sincronización; no compartas una instancia modificable entre hilos sin la sincronización adecuada.

StringBuilder() crea un búfer vacío con una capacidad de 16. StringBuilder(int) crea un búfer vacío con la capacidad especificada; un valor negativo provoca NegativeArraySizeException. La capacidad inicial no es la longitud del texto.

StringBuilder.length() devuelve el número de unidades char UTF-16 del contenido, que no tiene por qué coincidir con el número de caracteres visibles para el usuario. StringBuilder.capacity() indica el espacio para esas unidades, incluidas las posiciones ya ocupadas. La capacidad aumenta automáticamente cuando se necesita más espacio.

StringBuilder.setLength(int) devuelve void: una longitud menor trunca el final, mientras que una mayor añade caracteres con valor cero ('\u0000'), no espacios. Una longitud negativa provoca IndexOutOfBoundsException. setLength(0) elimina todo el contenido lógico; no lo consideres un borrado seguro de los datos de la memoria.

Ejemplos

public class Main {
    public static void main(String[] args) {
        StringBuilder defaults = new StringBuilder();
        System.out.println(defaults.length() + ":" + defaults.capacity());

        StringBuilder text = new StringBuilder(8);
        text.append("Java");
        System.out.println(text.length() + ":" + text.capacity());

        text.setLength(2);
        System.out.println(text.toString());

        text.setLength(4);
        System.out.println(text.length() + ":" + (int) text.charAt(2));

        text.setLength(0);
        System.out.println(text.length());
    }
}

Resultado

0:16
4:8
Ja
4:0
0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes