Entendendo Java String.charAt(): Sintaxe, Tipo de Retorno, Exceções e Exemplo Prático

O que é o Método Java String.charAt()?

O método String.charAt() retorna o caractere em um índice específico dentro de uma string. Em Java, índices de string são baseados em zero, variando de 0 a length() - 1.

Assinatura do Método

public char charAt(int index)

Parâmetro

index – um único valor int especificando a posição do caractere desejado.

Valor de Retorno

Retorna o caractere (tipo char) localizado no índice dado.

Exceções

Lança StringIndexOutOfBoundsException se index for negativo ou maior ou igual ao comprimento da string.

Exemplo Prático

public class ExemploCharAt {
    public static void main(String[] args) {
        String s = "This is String CharAt Method";
        // Caractere no índice 0
        System.out.println("Caractere na posição 0 é: " + s.charAt(0));
        // Caractere no índice 5
        System.out.println("Caractere na 5ª posição é: " + s.charAt(5));
        // Caractere no índice 22
        System.out.println("Caractere na 22ª posição é: " + s.charAt(22));
        // Tentativa de acessar índice inválido
        char invalido = s.charAt(-1);
        System.out.println("Caractere na posição -1 é: " + invalido);
    }
}

Saída:

Caractere na posição 0 é: T
Caractere na 5ª posição é: i
Caractere na 22ª posição é: M

Exception in thread “main” java.lang.StringIndexOutOfBoundsException: String index out of range: -1

Pontos-chave para lembrar:

• Apenas argumento int é aceito.
• O método retorna um char correspondente ao índice fornecido.
• Índices fora do intervalo válido disparam StringIndexOutOfBoundsException.
• Sempre garanta 0 <= index < s.length() antes de chamar charAt().