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]conversionString.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.