Formatage de chaînes en Java : String.format, printf et spécificateurs de format

Deux façons de formater

Java formate les chaînes à partir d'un modèle contenant des spécificateurs de format (les marqueurs %) ainsi que les valeurs à insérer. Il existe deux points d'entrée, et ils partagent une syntaxe identique :

• String.format(template, values...) renvoie une nouvelle String.
• System.out.printf(template, values...) affiche directement le résultat.

public class Main {
    public static void main(String[] args) {
        String name = "Ada";
        int age = 36;

        String line = String.format("%s is %d years old", name, age);
        System.out.println(line);

        System.out.printf("%s is %d years old%n", name, age);
    }
}

Les deux produisent le même texte. String.format vous le renvoie pour que vous puissiez le stocker ; printf l'écrit dans la console. Notez le %n à la fin du modèle de printf - c'est le saut de ligne indépendant de la plateforme (préférez-le à \n dans les chaînes de format).

Les spécificateurs courants

Chaque spécificateur commence par % et se termine par une lettre qui indique le type de valeur attendu :

public class Main {
    public static void main(String[] args) {
        System.out.printf("string: %s%n", "hello");
        System.out.printf("integer: %d%n", 42);
        System.out.printf("float: %f%n", 3.14);
        System.out.printf("boolean: %b%n", true);
        System.out.printf("char: %c%n", 'A');
        System.out.printf("hex: %x%n", 255);
        System.out.printf("percent sign: %%%n");
    }
}

Les trois utilisés au quotidien sont %s (n'importe quelle valeur, via son toString), %d (nombres entiers) et %f (décimaux). Utilisez %% pour afficher un signe pourcent littéral. Passer le mauvais type - par exemple une String à %d - lève une IllegalFormatConversionException à l'exécution.

Contrôler les décimales

%f utilise par défaut six décimales, ce qui correspond rarement à ce que vous voulez. Placez .N avant le f pour fixer la précision (la valeur est arrondie) :

public class Main {
    public static void main(String[] args) {
        double price = 3.14159;

        System.out.printf("%f%n", price);     // 3.141590
        System.out.printf("%.2f%n", price);   // 3.14
        System.out.printf("%.0f%n", price);   // 3
    }
}

Ajoutez l'indicateur de virgule pour les séparateurs de groupement sur les grands nombres :

public class Main {
    public static void main(String[] args) {
        double total = 1234567.891;
        System.out.printf("%,.2f%n", total);   // 1,234,567.89
    }
}

Largeur et remplissage

Un nombre entre le % et la lettre de type définit une largeur de champ minimale, en complétant par des espaces pour que les colonnes s'alignent. Un - en tête aligne à gauche ; un 0 en tête complète les nombres avec des zéros :

public class Main {
    public static void main(String[] args) {
        System.out.printf("[%10s]%n", "hi");    // right-aligned in 10 cols
        System.out.printf("[%-10s]%n", "hi");   // left-aligned
        System.out.printf("[%05d]%n", 42);      // zero-padded to width 5
    }
}

C'est ce qui rend lisibles les tableaux formatés et les rapports alignés :

public class Main {
    public static void main(String[] args) {
        String[] names = {"Ada", "Boris", "Chen"};
        int[] scores = {95, 8, 142};

        for (int i = 0; i < names.length; i++) {
            System.out.printf("%-8s %5d%n", names[i], scores[i]);
        }
    }
}

Le %-8s aligne les noms à gauche dans une colonne de 8 de large et %5d aligne les scores à droite dans une colonne de 5 de large, de sorte que les nombres s'alignent quel que soit le nombre de chiffres.

Ordre des arguments

Par défaut, les spécificateurs consomment les valeurs de gauche à droite. Vous pouvez répéter ou réordonner une valeur avec N$ (indice commençant à un), pratique lorsque la même valeur apparaît deux fois :

public class Main {
    public static void main(String[] args) {
        System.out.printf("%1$s, %1$s, hello %2$s%n", "echo", "world");
    }
}

%1$s fait référence au premier argument les deux fois, donc echo s'affiche deux fois.

La méthode formatted()

Depuis Java 15, chaque chaîne possède une méthode d'instance formatted - le même moteur que String.format, simplement écrit comme un appel de méthode sur le modèle :

public class Main {
    public static void main(String[] args) {
        String msg = "%s scored %d".formatted("Ada", 95);
        System.out.println(msg);
    }
}

Elle se marie particulièrement bien avec les text blocks (chaînes multilignes entre triples guillemets) pour construire des sorties formatées plus volumineuses.

Quand ne pas utiliser String.format

Pour de simples jointures ponctuelles, la concaténation classique avec + est plus claire et plus rapide :

String greeting = "Hi, " + name + "!";   // simpler than String.format here

Faites appel à String.format / printf quand vous avez besoin d'un vrai formatage - décimales fixes, remplissage, alignement, groupement - et pas seulement pour coller quelques valeurs.

Suite : Les opérateurs

Le formatage transforme des valeurs en texte. Pour calculer ces valeurs en premier lieu, vous avez besoin des opérateurs de Java - arithmétiques, de comparaison et logiques. C'est la page suivante.