CKTIS / Java
String.format — tekst opmaken
String.format maakt tekst op basis van een formatteertekenreeks en argumenten, met aanduidingen zoals %s, %d en %.2f. Een expliciete Locale maakt getalopmaak onafhankelijk van de standaardlandinstellingen van de omgeving.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversionString.format is een statische methode die een opgemaakte String teruggeeft; de methode drukt het resultaat niet zelf af. De formatteertekenreeks combineert gewone tekst met aanduidingen die door Formatter zijn gedefinieerd. De argumenten volgen op de formatteertekenreeks en worden doorgegeven als Object... args.
De overload String.format(String format, Object... args) gebruikt Locale.getDefault(Locale.Category.FORMAT). Met de variant String.format(Locale l, String format, Object... args) kun je de Locale expliciet opgeven; null betekent dat er geen lokalisatie wordt toegepast. Het voorbeeld gebruikt Locale.US, zodat het decimaalteken een punt is.
Voor veelgebruikte conversies is de syntaxis %[argument_index$][flags][width][.precision]conversion. %s formatteert de tekenreeksrepresentatie van een argument, %d een decimaal geheel getal en %.2f een drijvendekommagetal met twee cijfers na het decimaalteken. %04d stelt een minimale breedte van vier tekens in, aangevuld met nullen. %2$s selecteert het tweede argument. %% voegt een letterlijk % in zonder een argument te verbruiken; %n voegt het platformspecifieke regeleinde in.
Een ongeldige formatteertekenreeks, een incompatibel type of een ontbrekend vereist argument veroorzaakt IllegalFormatException. Zo accepteert %d geen String met cijfers. Extra argumenten worden genegeerd; de verwerking van null-waarden hangt af van de conversie. Houd zelf de controle over de formatteertekenreeks en geef variabele gegevens door als argumenten.
Voorbeelden
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);
}
}Resultaat
Ada | id=0007 | score=12.50 | 80%
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.