Функция padEnd

Функция padEnd добавляет указанный символ в конец строки до тех пор, пока строка не достигнет заданной длины. Если исходная строка уже имеет длину больше или равную указанной, то возвращается исходная строка без изменений.

Синтаксис

kotlinfun String.padEnd(length: Int, padChar: Char = ' '): String

Параметры

length - желаемая длина строки после добавления символов. Тип: Int.

padChar - символ для добавления в конец строки. По умолчанию используется пробел. Тип: Char.

Пример

Добавим пробелы в конец строки "abc" до длины 5:

kotlinval str = "abc"
val res = str.padEnd(5)
println(res)

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

kotlinString "abc  "

Пример

Добавим символ "-" в конец строки "123" до длины 6:

kotlinval str = "123"
val res = str.padEnd(6, '-')
println(res)

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

kotlinString "123---"

Пример

Если исходная строка уже имеет длину больше указанной, функция возвращает исходную строку без изменений:

kotlinval str = "abcdef"
val res = str.padEnd(4, '*')
println(res)

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

kotlinString "abcdef"

Пример

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

kotlinval str = "test"
val res1 = str.padEnd(8, '.')
val res2 = str.padEnd(8, '0')
println(res1)
println(res2)

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

kotlinString "test...."
String "test0000"

Пример

Функция padEnd часто используется для форматирования вывода текста в колонки:

kotlinval names = listOf("John", "Anna", "Michael")

for (name in names) {
  val formattedName = name.padEnd(10, ' ')
  println("$formattedName: ${name.length} chars")
}

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

kotlinString "John      : 4 chars"
String "Anna      : 4 chars"
String "Michael   : 7 chars"

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

  • функцию padStart,
    которая добавляет символы в начало строки
  • свойство length,
    которое содержит длину строки
  • функцию plus,
    которая объединяет строки
  • функцию repeat,
    которая повторяет строку указанное количество раз