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

CKTIS / Java

String.format — formatar texto

String.format cria texto a partir de uma cadeia de formato e de argumentos, usando especificadores como %s, %d e %.2f. Um Locale explícito torna a formatação numérica independente das definições regionais predefinidas do ambiente.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversion

String.format é um método estático que devolve um String formatado; não apresenta o resultado por si só. A cadeia de formato combina texto normal com especificadores definidos por Formatter. Os argumentos são passados depois da cadeia de formato como Object... args.

A sobrecarga String.format(String format, Object... args) utiliza Locale.getDefault(Locale.Category.FORMAT). A variante String.format(Locale l, String format, Object... args) permite especificar explicitamente o Locale; null significa que não é aplicada localização. O exemplo usa Locale.US para que o separador decimal seja um ponto.

Para conversões comuns, a sintaxe é %[argument_index$][flags][width][.precision]conversion. %s formata a representação em texto de um argumento, %d um número inteiro decimal e %.2f um número de vírgula flutuante com dois algarismos depois do separador decimal. %04d define uma largura mínima de quatro caracteres, preenchida com zeros. %2$s seleciona o segundo argumento. %% insere um % literal sem consumir um argumento; %n insere o separador de linha específico da plataforma.

Uma cadeia de formato inválida, um tipo incompatível ou a falta de um argumento obrigatório causa IllegalFormatException. Por exemplo, %d não aceita um String que contenha algarismos. Os argumentos excedentes são ignorados; o tratamento dos valores null depende da conversão. Mantenha o controlo da cadeia de formato e passe os dados variáveis como argumentos.

Exemplos

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        String result = String.format(
            Locale.US, "%s | id=%04d | score=%.2f | %d%%",
            "Ada", 7, 12.5, 80
        );
        System.out.print(result);
    }
}

Resultado

Ada | id=0007 | score=12.50 | 80%

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes