Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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]conversion

String.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.

Fonti