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.