CKTIS / Java
String.substring — een deel van een tekenreeks ophalen
String.substring geeft een deel van een tekenreeks terug zonder het origineel te wijzigen. Het begin is inbegrepen en het einde uitgesloten; indices tellen UTF-16-code-eenheden.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
String substring(int beginIndex)
String substring(int beginIndex, int endIndex)String.substring(beginIndex, endIndex) geeft het bereik [beginIndex, endIndex) terug, met lengte endIndex - beginIndex. De indices beginnen bij nul. String.substring(beginIndex) geeft het achtervoegsel tot het einde terug. Het origineel blijft ongewijzigd.
Vereist is 0 <= beginIndex <= endIndex <= length(). De variant met één argument vereist 0 <= beginIndex <= length(). Ongeldige grenzen veroorzaken IndexOutOfBoundsException. Gelijke grenzen, ook aan het einde, leveren een lege tekenreeks op.
Indices tellen UTF-16-code-eenheden (char), niet noodzakelijk volledige Unicode-tekens. Een grens kan een surrogaatpaar splitsen; behandel deze indices niet als posities van tekens die gebruikers waarnemen.
Voorbeelden
public class Main {
public static void main(String[] args) {
String text = "abcdef";
System.out.println(text.substring(1, 4));
System.out.println(text.substring(4));
System.out.println(text.substring(6).isEmpty());
System.out.println(text);
}
}Resultaat
bcd ef true abcdef
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.