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