Artigos Java Java String: Manipulando métodos da classe String

Neste artigo trataremos de um assunto muito comum no desenvolvimento de softwares em Java: o uso dos métodos da classe String. Vamos “destrinchar” os métodos com conceitos e exemplos de como utilizá-los. Esperamos que todas as dúvidas que havia em relação a essa classe possam ser sanadas com este artigo.

Antes de iniciarmos os exemplos e explicações dos métodos desta classe, é importante entender que na verdade a classe String é um “wrapper” de um vetor de “char”. Em outras palavras, o String está para um vetor de char assim como o Integer está para o tipo primitivo int. Não vamos entrar em detalhes do que seja um wrapper, pois não é foco deste artigo.

Por esse motivo é que o código da Listagem 1 tem o mesmo efeito para ambas as situações.

Listagem 1. vetor de char e String

char data[] = {'a', 'b', 'c'};
  String str = new String(data);

A principal diferença é que com o “char data[]” não tem-se todo o “poder” que a classe String nos proporciona para manipular esse vetor.

charAt

O nosso primeiro método é bem simples e consiste em retornar apenas um caractere em determinada posição de nossa String. Observe a Listagem 2.

Listagem 2. Uso do charAt

String valor = "DEVMEDIA - Java";
System.out.println(valor.charAt(0));

Saída: D

codePointAt

Retorna o valor em UNICODE do caractere especificado no index do parâmetro. Confira a Listagem 3.

Listagem 3. Uso do codePointAt

String valor = "DEVMEDIA - Java";

System.out.println(valor.codePointAt(0));

Saída: 68

Note que a codificação da letra 'D' correspondente a posição 0 na nossa String é igual a 68, considerando a codificação UNICODE.

compareTo e compareToIgnoreCase

Ambos fazem comparação de duas Strings, sendo que o primeiro (compareTo) considera letras maiúsculas e minúsculas na comparação e o segundo (compareToIgnoreCase) ignora qualquer diferença de minúsculas ou maiúsculas. Ambos também retornam a quantidade de diferenças, sendo que nos importa saber, no momento, que quando o retorno for igual a zero significa que não há diferenças entre a String. Observe a Listagem 4.

Listagem 4. Uso do compareTo e compareToIgnoreCase

String valor = "DEVMEDIA - Java";

  System.out.println(valor.compareTo("DEVMEDIA - Java") == 0 ? true : false);
  System.out.println(valor.compareTo("DEVMEDIA - JAVA") == 0 ? true : false);
  System.out.println(valor.compareToIgnoreCase
   ("DEVMEDIA - JAVA") == 0 ? true : false);

Saída:true
false
true

endsWith e startsWith

O método endsWith verifica se a String termina com o valor especificado, por outro lado o startsWith verifica se a String começa com o valor especificado. Sendo que o método startsWith tem duas variações: uma com o parâmetro “int toffset” e outra sem, onde o método que contém o parâmetro “int toffset” serve para dizer de onde deve começar a verificação do inicio da String. Veja o exemplo da Listagem 5.

Listagem 5. Uso do endsWith, startsWith e startsWith com tooffset

String valor = "DEVMEDIA - Java";

             System.out.println(valor.endsWith("Java"));
             System.out.println(valor.startsWith("DEV"));
             System.out.println(valor.startsWith("ME", 3));

Saída: true
true
true

toCharArray

Converte uma String em um Array de char, ou seja, uma String de 10 posições irá ser convertida em um vetor char[] de 10 posições, conforme a Listagem 6.

Listagem 6. Uso do toCharArray

String valor = "DEVMEDIA - Java";


             for(char c : valor.toCharArray()){
                    System.out.println("Char: "+c);
             }

Saída:
Char: D
Char: E
Char: V
Char: M
Char: E
Char: D
Char: I
Char: A
Char:
Char: -
Char:
Char: J
Char: a
Char: v
Char: a

getBytes

Converte a String em um vetor de byte[]. Este método é muito útil principalmente quando precisamos salvar caracteres no banco desconsiderando a codificação atual. No PostgreSQL, por exemplo, você pode utilizar o tipo “bytea” que é análogo ao “byte” em Java. Assim como você pode converter para byte, você também pode voltar para String ou char. Observe a Listagem 7.

Listagem 7. Uso do getBytes

String valor = "DEVMEDIA - Java";
                    for(byte b : valor.getBytes()){
                    System.out.println("byte: "+b);
             }

Saída:
byte: 68
byte: 69
byte: 86
byte: 77
byte: 69
byte: 68
byte: 73
byte: 65
byte: 32
byte: 45
byte: 32
byte: 74
byte: 97
byte: 118
byte: 97

isEmpty

Um método muito utilizado e comum que verifica se uma String está ou não vazia, mas tenha atenção neste método, pois a verificação baseia-se se sua String possui tamanho = 0, ou seja, o String.length() = 0. Isso significa que caso você tente utilizar o isEmpty() em uma String que possui valor NULL você receberá um NullPointerException. Analise o exemplo da Listagem 8.

Listagem 8. Usando isEmpty de forma errada

String valor = null;
System.out.println(valor.isEmpty());

Saída: Exception in thread "main" java.lang.NullPointerException
       at StringManager.main(StringManager.java:9)

split

O método split cria um array de Strings com base no “regex” passado via parâmetro, ou seja, ele divide a String em várias outras Strings com base no seu regex, o que é muito útil para separar tags em uma String completa, ex: “software, engenharia, computação”. Você pode transformar essa única String em um array com três Strings.

Este método também possui uma variação, que é o parâmetro “int limit”, onde você identifica quantas vezes o regex será aplicado em toda String. Vamos ver exemplos presentes na Listagem 9.

Listagem 9. Usando split e split com limit

/*
              * Uso do split sem o LIMIT
              * */
             String valor = "DEVMEDIA - Java";
             String[] valorComSplit = valor.split("-");

             for(String s : valorComSplit){
                    System.out.println(s);
             }
Saída:DEVMEDIA
 Java

/*
              * Uso do split com o LIMIT
              * */
             String valor = "DEVMEDIA - Java - Engenharia - Software";
             String[] valorComSplit = valor.split("-", 2);

             for(String s : valorComSplit){
                    System.out.println(s);
             }

Saída:
DEVMEDIA
 Java - Engenharia - Software

Por que no segundo bloco de código o split não divide “Java – Engenharia – Software” ? Simples, pois explicitamente dizemos quantas vezes o regex será aplicado, o que influência diretamente no tamanho final do nosso vetor, que será igual a dois.

substring e subSequence

Ambos os métodos retornam uma parte específica de uma determinada String, sendo que o método substring retorna uma nova String e o método subSequence retorna um CharSequence. É importante ressaltar que o CharSequence é uma interface e a String é a implementação dessa interface. Observe o exemplo da Listagem 10.

Listagem 10. Usando substring e subSequence

String valor = "DEVMEDIA - Java";

             System.out.println(valor.subSequence(0, 5));
             System.out.println(valor.substring(0, 5));

Saída:
DEVME
DEVME

toLowerCase, toUpperCase e trim

O método toLowerCase converte toda a String para caixa baixa e o toUpperCase faz o inverso, convertendo toda a String para caixa alta. O método trim remove espaços em branco no inicial e no final da String, conforme exemplo da Listagem 11.

Listagem 11. Uso do toLowerCase, toUpperCase e trim

String valor = "DEVMEDIA - Java";

             System.out.println(valor.toLowerCase());
             System.out.println(valor.toUpperCase());
             System.out.println(valor.trim());

Saída:
devmedia - java
DEVMEDIA - JAVA
DEVMEDIA - Java

valueOf

Este método converte diversos tipos (booleano, inteiro, char, double, float, long, Object e etc) para String, conforme exemplo da Listagem 12.

Listagem 12. Uso do valueOf

//boolean
             boolean myBoolean = true;
             System.out.println(String.valueOf(myBoolean));

             //float
             float myFloat = -10;
             System.out.println(String.valueOf(myFloat));

             //int
             int myInt = 9;
             System.out.println(String.valueOf(myInt));

             ///double
             double myDouble = 10.30;
             System.out.println(String.valueOf(myDouble));

Saída:
true
-10.0
9
10.3

format

Como o próprio já sugere, o String.format realiza a formatação de uma String de acordo com as especificações passadas. Vamos ver como funciona no exemplo da Listagem 13.

Listagem 13. Uso do format

String result = String.format("Hoje nós processamos %,d transações", 100000);
             System.out.println(result);

             result = String.format("10 / 3 = %.2f", 10.0 / 3.0);
             System.out.println(result);

Em resumo, temos a String em si e os objetos que serão usados na formatação.

O objetivo deste artigo foi demonstrar o uso com detalhes da classe String e a maioria dos seus métodos, definindo conceitos práticos e diretos juntamente com exemplos do funcionamento de cada um deles. Estudar esses tipos de Wrapper, como é o caso do Boolean, Integer entre outros, é importante para saber como manipular de forma correta os dados da sua aplicação, aumentando a produtividade e evitando trabalho desnecessário.

Um exemplo comum é o uso do subString, que lhe auxilia no retorno de uma determinada parcela da String, enquanto que caso você não conhecesse tal recurso, seria obrigado a criar um laço de repetição para retornar os caracteres dentro do intervalo desejado, tarefas simples e triviais acabam tornando-se um problema quando não temos o conhecimento necessário para realizá-las.