CKTIS / Java
String.concat(String)
Em Java SE 21, `String.concat(String)` acrescenta uma cadeia ao fim de outra. Se o argumento estiver vazio, devolve o objeto original.
Versão: Java SE 21
Sintaxe
public String concat(String str)String.concat(String) acrescenta o argumento ao fim da cadeia recetora. Os objetos String são imutáveis. Se o argumento estiver vazio, o método devolve o mesmo objeto. Um argumento null provoca NullPointerException. Em contraste, a concatenação de cadeias com + converte uma referência null no texto "null".
O exemplo invoca concat através de um handle de método. Na pesquisa de concat, MethodType.methodType(String.class, String.class) indica primeiro o tipo de retorno e depois o tipo do parâmetro declarado. O handle recebe primeiro o objeto recetor e depois a cadeia a acrescentar. A conversão explícita para String estabelece no local da chamada o tipo de retorno exigido por invokeExact.
Exemplos
import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;
public class Main {
public static void main(String[] args) throws Throwable {
MethodHandles.Lookup lookup = MethodHandles.lookup();
MethodHandle concat = lookup.findVirtual(
String.class, "concat", MethodType.methodType(String.class, String.class));
MethodHandle length = lookup.findVirtual(
String.class, "length", MethodType.methodType(int.class));
String prefix = "A";
String joined = (String) concat.invokeExact(prefix, "\uD83D\uDE00");
int units = (int) length.invokeExact(joined);
String unchanged = (String) concat.invokeExact(prefix, "");
System.out.println(units);
System.out.println(unchanged == prefix);
}
}Resultado
3 true
O exemplo acrescenta o emoji U+1F600 a `A`. A chamada a `length()` serve apenas para medir o resultado: `A` ocupa uma unidade de código UTF-16 e o emoji ocupa duas. A primeira linha mostra, por isso, `3`. A segunda mostra `true`: ao acrescentar uma cadeia vazia, `==` confirma que `concat` devolveu o mesmo objeto.
Lições relacionadas
- Java · Lição 56 · Avançado · Versão: 2
Fontes
- String (Java SE 21 & JDK 21) — concat(String)
- String (Java SE 21 & JDK 21) — length()
- MethodHandles.Lookup (Java SE 21 & JDK 21) — findVirtual
- MethodType (Java SE 21 & JDK 21)
- MethodHandle (Java SE 21 & JDK 21) — invokeExact
- Java Language Specification, Java SE 21 — §15.8.2 Class Literals
- Java Language Specification, Java SE 21 — §15.18.1 String Concatenation Operator +
- Java Language Specification, Java SE 21 — §5.1.11 String Conversion