CKTIS / Java
String.substring — pridobivanje dela niza
String.substring vrne del niza, ne da bi spremenil izvirnik. Začetek je vključen, konec pa izključen; indeksi štejejo kodne enote UTF-16.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
String substring(int beginIndex)
String substring(int beginIndex, int endIndex)String.substring(beginIndex, endIndex) vrne območje [beginIndex, endIndex) z dolžino endIndex - beginIndex. Indeksi se začnejo z ničlo. String.substring(beginIndex) vrne pripono do konca. Izvirni niz ostane nespremenjen.
Veljati mora 0 <= beginIndex <= endIndex <= length(). Različica z enim argumentom zahteva 0 <= beginIndex <= length(). Neveljavne meje povzročijo IndexOutOfBoundsException. Enaki meji, tudi na koncu, ustvarita prazen niz.
Indeksi štejejo kodne enote UTF-16 (char), ne nujno celotnih znakov Unicode. Meja lahko razdeli par nadomestnih znakov; teh indeksov ne uporabljajte za določanje položajev posameznih znakov, kot jih vidi uporabnik.
Primeri
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);
}
}Rezultat
bcd ef true abcdef
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.