CKTIS / Java
O construtor de cópia String(String)
O construtor `String(String)` cria um objeto distinto com o mesmo texto. `==` compara referências, enquanto `equals` compara o conteúdo das cadeias de caracteres.
Versão: Java SE 21
Sintaxe
public String(String original)
String copy = new String(original);Em Java SE 21, String(String) é a sobrecarga do construtor de java.lang.String que recebe uma cadeia de caracteres existente. Cada avaliação bem-sucedida de new String(original) cria um objeto distinto que representa a mesma sequência de caracteres que original. Ter uma identidade distinta não garante que os caracteres sejam armazenados separadamente. Se o argumento do tipo String for null, o construtor lança NullPointerException.
Todas as ocorrências do literal "Alpha" referem-se ao mesmo objeto no conjunto de cadeias internadas. Já duas avaliações de new String("Alpha") criam dois objetos distintos entre si e distintos do objeto do literal. Para referências, == verifica se ambas apontam para o mesmo objeto ou se ambas são null. Se s for uma cadeia não nula, s.equals(t) devolve true quando t é uma cadeia com a mesma sequência de caracteres, distinguindo maiúsculas de minúsculas.
String alias = original; copia a referência sem criar um novo objeto. As cadeias são imutáveis, por isso reutiliza a referência existente se só precisares de passar o texto. Usa o construtor de cópia apenas quando precisares de um objeto com identidade distinta.
Exemplos
public class StringCopyDemo {
public static void main(String[] args) {
String literal = "Alpha";
String alias = literal;
String first = new String("Alpha");
String second = new String("Alpha");
System.out.println(literal == "Alpha");
System.out.println(alias == literal);
System.out.println(first == literal);
System.out.println(first == second);
System.out.println(first.equals(second));
}
}Resultado
true true false false true
Os dois primeiros `true` mostram a partilha do objeto do literal e a atribuição da referência. Os dois `false` mostram que a primeira cópia é distinta tanto do objeto do literal como da segunda cópia. O último `true` confirma que ambas as cópias contêm o mesmo texto.
Lições relacionadas
- Java · Lição 17 · Avançado · Versão: 2
Fontes
- Java SE 21 API — String(String original)
- Java SE 21 API — String class description and null-argument convention
- Java SE 21 API — String.equals(Object)
- Java Language Specification, Java SE 21 — §3.10.5 String Literals
- Java Language Specification, Java SE 21 — §15.9.4 Run-Time Evaluation of Class Instance Creation Expressions
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=