Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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