Функция format

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

Импорт

import kotlin.text.format

Синтаксис

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

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

Пример

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

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

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

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

Пример

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

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

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

String "PI value: 3.14"

Пример

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

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

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

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

Пример

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

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

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

String "y: 20, x: 10"

Пример

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

import java.util.Locale

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

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

String "Number: 1,234.57"

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

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

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

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

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

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

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

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

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

функцию plus,
которая выполняет конкатенацию строк
функцию replace,
которая заменяет часть строки на другую
функцию substring,
которая извлекает подстроку из строки
функцию joinToString,
которая объединяет элементы коллекции в строку