Функция padStart

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

Синтаксис

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

Параметры

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

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

Пример

Дополним строку "123" пробелами до длины 6:

kotlinval str = "123"
val res = str.padStart(6)
println(res)

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

kotlinString "   123"

Пример

Дополним строку "abc" нулями до длины 5:

kotlinval str = "abc"
val res = str.padStart(5, '0')
println(res)

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

kotlinString "00abc"

Пример

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

kotlinval str = "hello"
val res = str.padStart(3, '-')
println(res)

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

kotlinString "hello"

Пример

Использование padStart для форматирования чисел с ведущими нулями:

kotlinval number = 42
val strNumber = number.toString()
val formatted = strNumber.padStart(5, '0')
println(formatted)

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

kotlinString "00042"

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

  • функцию padEnd,
    которая дополняет строку символами в конце
  • свойство length,
    которое содержит длину строки
  • функцию trim,
    которая удаляет пробелы в начале и конце строки
  • функцию format,
    которая форматирует строку по заданному шаблону