База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

String.format — форматиране на текст

String.format създава текст от форматен низ и аргументи чрез спецификатори като %s, %d и %.2f. Изрично зададен Locale прави форматирането на числа независимо от настройките за регион на средата по подразбиране.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversion

String.format е статичен метод, който връща форматиран String; самият метод не отпечатва резултата. Форматният низ съчетава обикновен текст със спецификатори, определени от Formatter. Аргументите се подават след форматния низ като Object... args.

Претовареният метод String.format(String format, Object... args) използва Locale.getDefault(Locale.Category.FORMAT). Вариантът String.format(Locale l, String format, Object... args) позволява Locale да бъде зададен изрично; null означава, че не се прилага локализация. Примерът използва Locale.US, така че десетичният разделител да е точка.

При обичайните преобразувания синтаксисът е %[argument_index$][flags][width][.precision]conversion. %s форматира низовото представяне на аргумент, %d — десетично цяло число, а %.2f — число с плаваща запетая с две цифри след десетичния разделител. %04d задава минимална ширина от четири знака с допълване с нули. %2$s избира втория аргумент. %% вмъква буквален %, без да използва аргумент; %n вмъква разделителя за нов ред, специфичен за платформата.

Невалиден форматен низ, несъвместим тип или липсващ задължителен аргумент води до IllegalFormatException. Например %d не приема String, съдържащ цифри. Допълнителните аргументи се игнорират, а обработката на стойности null зависи от преобразуването. Запазете контрола върху форматния низ и подавайте променливите данни като аргументи.

Примери

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);
    }
}

Резултат

Ada | id=0007 | score=12.50 | 80%

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници