CKTIS / Java
String.format — formattare il testo
String.format crea testo a partire da una stringa di formato e da argomenti, usando specificatori come %s, %d e %.2f. Un Locale esplicito rende la formattazione dei numeri indipendente dalle impostazioni locali predefinite dell’ambiente.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversionString.format è un metodo statico che restituisce un String formattato; non stampa direttamente il risultato. La stringa di formato combina testo normale e specificatori definiti da Formatter. Gli argomenti seguono la stringa di formato e vengono passati come Object... args.
L’overload String.format(String format, Object... args) usa Locale.getDefault(Locale.Category.FORMAT). La variante String.format(Locale l, String format, Object... args) consente di specificare esplicitamente il Locale; null significa che non viene applicata alcuna localizzazione. L’esempio usa Locale.US affinché il separatore decimale sia un punto.
Per le conversioni comuni, la sintassi è %[argument_index$][flags][width][.precision]conversion. %s formatta la rappresentazione testuale di un argomento, %d un intero decimale e %.2f un numero in virgola mobile con due cifre dopo il separatore decimale. %04d imposta una larghezza minima di quattro caratteri con riempimento di zeri. %2$s seleziona il secondo argomento. %% inserisce un % letterale senza consumare un argomento; %n inserisce il separatore di riga specifico della piattaforma.
Una stringa di formato non valida, un tipo incompatibile o la mancanza di un argomento richiesto causa IllegalFormatException. Per esempio, %d non accetta un String contenente cifre. Gli argomenti in eccesso vengono ignorati; il trattamento dei valori null dipende dalla conversione. Mantieni il controllo sulla stringa di formato e passa i dati variabili come argomenti.
Esempi
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);
}
}Risultato
Ada | id=0007 | score=12.50 | 80%
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.