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

CKTIS / Java

PrintStream.printf — sortie formatée

PrintStream.printf écrit des données selon une chaîne de format, par exemple vers System.out. La méthode permet de contrôler l’affichage des nombres et du texte, et de choisir explicitement une locale.

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

Syntaxe

public PrintStream printf(String format, Object... args)
public PrintStream printf(Locale l, String format, Object... args)

PrintStream.printf écrit des données formatées dans un flux au lieu de renvoyer du texte. Elle renvoie le même PrintStream, ce qui permet d’enchaîner les appels. Les deux surcharges se comportent comme les appels format correspondants.

printf(String format, Object... args) utilise les paramètres par défaut de Locale.Category.FORMAT. printf(Locale l, String format, Object... args) applique la locale fournie ; passer null pour l désactive la localisation. Les arguments supplémentaires sont ignorés.

%s formate la représentation textuelle d’un argument, %d formate un entier en décimal et %.2f formate un nombre à virgule flottante avec deux chiffres après le séparateur décimal. %% écrit % et %n écrit le séparateur de ligne propre à la plateforme ; aucun des deux ne consomme d’argument. printf n’ajoute pas automatiquement de fin de ligne.

Un format invalide, un type d’argument incompatible ou un argument manquant provoque IllegalFormatException ; une valeur null pour format provoque NullPointerException. Ne passez pas de texte non fiable comme format : utilisez le format fixe "%s" et transmettez le texte comme argument.

Exemples

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        System.out.printf(Locale.US, "%s: %d | %.2f | 100%%%n", "Result", 3, 12.5);
    }
}

Résultat

Result: 3 | 12.50 | 100%

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