KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

StringBuilder — een wijzigbare tekstbuffer

Met StringBuilder kun je tekst stapsgewijs opbouwen en aanpassen. Leer het verschil tussen lengte en capaciteit en wat er gebeurt wanneer setLength de reeks afkapt of uitbreidt.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

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

java.lang.StringBuilder is een wijzigbare tekenreeks. append voegt inhoud toe en toString() maakt de resulterende String. De klasse garandeert geen synchronisatie; deel een wijzigbare instantie niet tussen threads zonder passende synchronisatie.

StringBuilder() maakt een lege buffer met capaciteit 16. StringBuilder(int) maakt een lege buffer met de opgegeven capaciteit; een negatieve waarde veroorzaakt NegativeArraySizeException. De begincapaciteit is niet de tekstlengte.

StringBuilder.length() geeft het aantal UTF-16-char-eenheden in de inhoud terug, niet noodzakelijk het aantal voor gebruikers zichtbare tekens. StringBuilder.capacity() geeft de ruimte voor die eenheden aan, inclusief al bezette posities. De capaciteit groeit automatisch wanneer er meer ruimte nodig is.

StringBuilder.setLength(int) geeft void terug: een kleinere lengte kapt het einde af, terwijl een grotere lengte tekens met waarde nul ('\u0000') toevoegt, geen spaties. Een negatieve lengte veroorzaakt IndexOutOfBoundsException. setLength(0) verwijdert alle logische inhoud; beschouw dit niet als het veilig wissen van gegevens uit het geheugen.

Voorbeelden

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());
    }
}

Resultaat

0:16
4:8
Ja
4:0
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen