Tweet

Curso de Java – A Classe StringBuilder

A classe StringBuilder em Java é empregada na criação e manipulação de informações do tipo string dinâmicas, ou seja, strings que são modificáveis. Seu uso é altamente recomendado em programas onde as strings são frequentemente concatenadas ou sofrem algum outro tipo de manipulação.

Esta classe possui três construtores principais:

• É possível criar um objeto StringBuilder sem passar nenhum argumento ao construtor, criando assim um objeto com capacidade padrão inicial de 16 caracteres. A capacidade aumenta de acordo com a informação que é armazenada no objeto.
• Outra possibilidade é passar um número inteiro ao método construtor, especificando a capacidade (número de caracteres) que o objeto terá inicialmente.
• Muito comum também é passar como argumento uma string de caracteres, que criará um objeto contendo esses caracteres. Neste caso, a capacidade inicial será o número de caracteres passados mais 16.

Para exibir o valor armazenado em uma StringBuilder, podemos usar o método toString, por exemplo com as funções printf ou println.

Vejamos exemplos da criação de objetos com StringBuilder.

StringBuilder string1 = new StringBuilder();
StringBuilder string2 = new StringBuilder(49);
StringBuilder string3 = new StringBuilder("Bóson Treinamentos");
System.out.printf("string1 = \"%s\"%n", string1);
System.out.printf("string2 = \"%s\"%n", string2);
System.out.printf("string3 = \"%s\"%n", string3);

Alguns métodos comuns da classe StringBuilder

Vamos estudar agora alguns métodos bastante comuns, que incluem os métodos length, capacity, ensureCapacity e setLength.

• Método length: Retorna o número de caracteres armazenados no momento no objeto
• Método capacity: Mostrea o número de caracteres que podem ser armazenados no objeto sem a necessidade de alocar mais memória.
• Método ensureCapacity: Garante que o objeto tenha, no mínimo, a capacidade especificada.
• Método setLength: Aumenta ou diminui o comprimento de um objeto.

Vejamos exemplos de uso desses métodos.

StringBuilder string1 = new StringBuilder("Bóson Treinamentos");
System.out.printf("string1 = %s%nComprimento = %d%nCapacidade = %d%n%n",
string1.toString(), string1.length(), string1.capacity());
string1.ensureCapacity(50);
System.out.printf("Nova capacidade é = %d%n%n", string1.capacity());
string1.setLength(15);
System.out.printf("O novo comprimento é = %d%nstring1 = %s%n", string1.length(), string1.toString());

Como manipular caracteres em um objeto StringBuilder

Vários métodos são fornecidos para a manipulação de caracteres nos objetos da classe. Entre eles, destacamos os seguintes:

• Método charAt – Recebe um inteiro como argumento e retorna o caractere armazenado no objeto, na posição desse número de índice.
• Método setCharAt – Recebe dois argumentos: um inteiro e um caractere, gravando o caractere passado na posição especificada pelo valor inteiro.
• Método getChars – Copia caracteres de uma StringBuilder para um array de caracteres que é passado como argumento ao método. O método usa quatro argumentos: valor de índice inicial a partir do qual os caracteres serão copiados, índice final do último caractere a ser copiado + 1, o array de caracteres que recerberá os caracteres copiados, e o índice (local) do array onde se iniciará a cópia dos caracteres.
• Método reverse – Este método inverte o conteúdo do objeto – ou seja, reverte a string armazenada.

Vejamos exemplos desses métodos.

StringBuilder string1 = new StringBuilder("bóson treinamentos");
System.out.printf("string1 = %s%n", string1.toString());
System.out.printf("Caractere na posição 0: %s%nCaractere na posição 7: %s%n%n",string1.charAt(0), string1.charAt(7));
char[] arrayCaracteres = new char[string1.length()];
string1.getChars(0, string1.length(), arrayCaracteres, 0);
System.out.print("Os caracteres armazenados são: ");
for (char c : arrayCaracteres)
  System.out.print(c);
string1.setCharAt(0, 'B');
string1.setCharAt(6, 'T');
System.out.printf("%n%nstring1 = %s", string1.toString());
string1.reverse();
System.out.printf("%n%nstring1 = %s%n", string1.toString());

Como acrescentar valores em um objeto StringBuilder

Usamos o método sobrecarregado append para adicionar valores de vários tipos ao objeto criado. É possível anexar valores de vários tipos, como tipos primitivos, arrays de caracteres, objetos, Strings, e outros. Como exemplo, vamos acrescentar diversos dados, de vários tipos, a um objeto criado:

String palavra = "Bóson";
char[] arrayCaract = {'F', 'A', 'B', 'I', 'O'};
boolean valorBool = true;
char caractere = 'T';
int valorInteiro = 33;
float valorFloat = 21.5f;
double valorDouble = 100.1953;
StringBuilder outraString = new StringBuilder("Fábio dos Reis");
StringBuilder string1 = new StringBuilder();
string1.append(palavra)
  .append("\n")
  .append(arrayCaract)
  .append("\n")
  .append(arrayCaract, 0, 3)
  .append("\n")
  .append(valorBool)
  .append("\n")
  .append(caractere)
  .append("\n")
  .append(valorInteiro)
  .append("\n")
  .append(valorFloat)
  .append("\n")
  .append(valorDouble)
  .append("\n")
  .append(outraString);
System.out.printf("Conteúdo do objeto StringBuilder: %n%s%n", string1.toString());

Concatenação de strings com StringBuilder

Podemos concatenar strings facilmente usando o método append. Veja o exemplo a seguir:

String texto1 = "Bóson";
String texto2 = "Treinamentos";
int idade = 6;
String resultado = new StringBuilder().append(texto1).append(" ").append(texto2).append(" ").append(idade).append(" ").append("anos!").toString();
System.out.printf("%s",resultado);

Neste exemplo concatenamos strings de caracteres, conteúdo de variáveis do tipo String e números inteiros em um objeto de nome resultado.

Obs.: Objetos StringBuilder não não são seguros em threads múltiplas. Se várias threads precisarem acessar a mesma informação de string dinâmica, é recomendável usar a classe StringBuffer, a qual oferece funcionalidade idêntica à classe StringBuilder, mas com segurança em threads.

Na segunda parte deste tutorial vamos estudar mais alguns métodos importantes da classe StringBuilder, como os métodos insert, delete e deleteCharAt, entre outros.