CKTIS / Java
String.format — formatowanie tekstu
String.format tworzy tekst z szablonu i argumentów, używając specyfikatorów takich jak %s, %d i %.2f. Jawne Locale pozwala uniezależnić format liczb od domyślnych ustawień środowiska.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversionString.format jest metodą statyczną zwracającą sformatowany String; sama nie wypisuje wyniku. Szablon łączy zwykły tekst ze specyfikatorami opisanymi przez Formatter. Argumenty przekazuje się po szablonie jako Object... args.
Przeciążenie String.format(String format, Object... args) korzysta z Locale.getDefault(Locale.Category.FORMAT). Wariant String.format(Locale l, String format, Object... args) pozwala jawnie określić ustawienia regionalne; null oznacza brak lokalizacji. Przykład używa Locale.US, aby separatorem dziesiętnym była kropka.
Dla typowych konwersji składnia to %[argument_index$][flags][width][.precision]conversion. %s formatuje tekstową reprezentację argumentu, %d liczbę całkowitą w zapisie dziesiętnym, a %.2f liczbę zmiennoprzecinkową z dwiema cyframi po separatorze. %04d ustala minimalną szerokość czterech znaków i uzupełnianie zerami. %2$s wskazuje drugi argument. %% wstawia znak % bez zużywania argumentu; %n wstawia separator wiersza zależny od platformy.
Niepoprawny szablon, niezgodny typ lub brak wymaganego argumentu powoduje IllegalFormatException. Na przykład %d nie przyjmuje String zawierającego cyfry. Nadmiarowe argumenty są ignorowane, a obsługa null jako wartości zależy od konwersji. Utrzymuj kontrolę nad szablonem, a zmienne dane przekazuj jako argumenty.
Przykłady
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);
}
}Wynik
Ada | id=0007 | score=12.50 | 80%
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.