padStart

fun CharSequence.padStart(length: Int, padChar: Char = ' '): CharSequence

Returns a char sequence with content of this char sequence padded at the beginning to the specified length with the specified character or space.

Return

Returns a char sequence of length at least length consisting of this char sequence prepended with padChar as many times as are necessary to reach that length.

Samples

import samples.*
import java.util.Locale
import kotlin.test.*
fun main() { 
   //sampleStart 
   val padWithSpace = "125".padStart(5)
assertPrints("'$padWithSpace'", "'  125'")

val padWithChar = "a".padStart(5, '.')
assertPrints("'$padWithChar'", "'....a'")

// string is returned as is, when its length is greater than the specified
val noPadding = "abcde".padStart(3)
assertPrints("'$noPadding'", "'abcde'") 
   //sampleEnd
}

Parameters

length

the desired string length.

padChar

the character to pad string with, if it has length less than the length specified. Space is used by default.

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

Pads the string to the specified length at the beginning with the specified character or space.