Функция format

Функция format выполняет форматирование строки с использованием спецификаторов формата. Применяется к строке, содержащей спецификаторы, и принимает аргументы для подстановки. Спецификаторы начинаются с символа % и определяют тип и формат подставляемого значения.

Импорт

kotlinimport kotlin.text.format

Синтаксис

kotlinfun String.format(vararg args: Any?): String

kotlinfun String.format(locale: Locale, vararg args: Any?): String

Пример

Отформатируем строку с подстановкой целого числа:

kotlinval name = "John"
val age = 25
val res = "My name is %s, I'm %d years old".format(name, age)
println(res)

Результат выполнения кода:

kotlinString "My name is John, I'm 25 years old"

Пример

Отформатируем строку с подстановкой числа с плавающей точкой:

kotlinval pi = 3.14159
val res = "PI value: %.2f".format(pi)
println(res)

Результат выполнения кода:

kotlinString "PI value: 3.14"

Пример

Используем несколько спецификаторов с разными типами данных:

kotlinval product = "apple"
val count = 5
val price = 12.99
val res = "Product: %s, count: %d, price: %.2f".format(product, count, price)
println(res)

Результат выполнения кода:

kotlinString "Product: apple, count: 5, price: 12.99"

Пример

Используем спецификаторы с указанием позиции аргументов:

kotlinval x = 10
val y = 20
val res = "y: %2\$d, x: %1\$d".format(x, y)
println(res)

Результат выполнения кода:

kotlinString "y: 20, x: 10"

Пример

Используем функцию с указанием локали:

kotlinimport java.util.Locale

val number = 1234.5678
val res = "Number: %,.2f".format(Locale.US, number)
println(res)

Результат выполнения кода:

kotlinString "Number: 1,234.57"

Основные спецификаторы формата

%s - для строковых значений

%d - для целых чисел

%f - для чисел с плавающей точкой

%c - для символов

%b - для логических значений

%n - для перевода строки

%% - для вывода символа процента

Смотрите также