CKTIS / Java
String.substring — extrair parte de uma cadeia de caracteres
String.substring devolve parte de uma cadeia de caracteres sem alterar o original. O início é incluído e o fim excluído; os índices contam unidades de código UTF-16.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
String substring(int beginIndex)
String substring(int beginIndex, int endIndex)String.substring(beginIndex, endIndex) devolve o intervalo [beginIndex, endIndex), com o comprimento endIndex - beginIndex. Os índices começam em zero. String.substring(beginIndex) devolve o sufixo até ao fim. A cadeia original permanece inalterada.
É necessário que se verifique 0 <= beginIndex <= endIndex <= length(). A sobrecarga com um argumento exige 0 <= beginIndex <= length(). Limites inválidos causam IndexOutOfBoundsException. Limites iguais, incluindo no fim, produzem uma cadeia vazia.
Os índices contam unidades de código UTF-16 (char), não necessariamente caracteres Unicode completos. Um limite pode dividir um par de substitutos; não interprete estes índices como posições de caracteres percecionados pelo utilizador.
Exemplos
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);
}
}Resultado
bcd ef true abcdef
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.