padEnd

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

Returns a char sequence with content of this char sequence padded at the end 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 appended 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".padEnd(5)
assertPrints("'$padWithSpace'", "'125  '")

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

// string is returned as is, when its length is greater than the specified
val noPadding = "abcde".padEnd(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.padEnd(length: Int, padChar: Char = ' '): String

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

Return

Returns a string of length at least length consisting of this string appended 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".padEnd(5)
assertPrints("'$padWithSpace'", "'125  '")

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

// string is returned as is, when its length is greater than the specified
val noPadding = "abcde".padEnd(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.