Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

String.format — formater du texte

String.format construit du texte à partir d’une chaîne de format et d’arguments, à l’aide de spécificateurs tels que %s, %d et %.2f. Un Locale explicite rend le formatage numérique indépendant des paramètres régionaux par défaut de l’environnement.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

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

String.format est une méthode statique qui renvoie un String formaté ; elle n’affiche pas elle-même le résultat. La chaîne de format associe du texte ordinaire à des spécificateurs définis par Formatter. Les arguments suivent la chaîne de format et sont transmis sous la forme Object... args.

La surcharge String.format(String format, Object... args) utilise Locale.getDefault(Locale.Category.FORMAT). La variante String.format(Locale l, String format, Object... args) permet de préciser explicitement le Locale ; null signifie qu’aucune localisation n’est appliquée. L’exemple utilise Locale.US afin que le séparateur décimal soit un point.

Pour les conversions courantes, la syntaxe est %[argument_index$][flags][width][.precision]conversion. %s formate la représentation en chaîne d’un argument, %d un entier décimal et %.2f un nombre à virgule flottante avec deux chiffres après le séparateur décimal. %04d définit une largeur minimale de quatre caractères avec un remplissage par des zéros. %2$s sélectionne le deuxième argument. %% insère un % littéral sans consommer d’argument ; %n insère le séparateur de ligne propre à la plateforme.

Une chaîne de format incorrecte, un type incompatible ou l’absence d’un argument requis provoque IllegalFormatException. Par exemple, %d n’accepte pas un String contenant des chiffres. Les arguments supplémentaires sont ignorés ; le traitement des valeurs null dépend de la conversion. Gardez le contrôle de la chaîne de format et transmettez les données variables comme arguments.

Exemples

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);
    }
}

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources