KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.length — lengte in UTF-16-code-eenheden

String.length() geeft het aantal UTF-16-code-eenheden terug, wat niet per se gelijk is aan het aantal voor gebruikers zichtbare tekens.

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

Syntax

public int length()
text.length()

String.length is een instantiemethode: de aanroep text.length() heeft geen argumenten en geeft een int terug. Een lege tekenreeks geeft 0 terug.

De methode telt UTF-16-code-eenheden, oftewel char-waarden. Een aanvullend Unicode-teken neemt een surrogaatpaar in en verhoogt het resultaat daardoor met 2. Zie dit resultaat niet als het aantal voor gebruikers zichtbare tekens.

Gebruik text.codePointCount(0, text.length()) om codepoints te tellen. In het voorbeeld leveren A en de emoji een lengte van 3 op, maar samen twee codepoints.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00";
        System.out.println(text.length());
        System.out.println(text.codePointCount(0, text.length()));
        System.out.println("".length());
    }
}

Resultaat

3
2
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