التابع text.padStart()‎ في لغة Kotlin

تعيد الدالة padStart()‎ سلسلة نصية أو سلسلة حروف تساوي السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها ولكن مع تطويلها ليساوي طولها العدد المُمرّر length، التطويل يكون بإضافة الوسيط padChar إلى بداية السلسلة النصية أو سلسلة الحروف، وقيمتها الابتدائية هي المسافة البيضاء (space).

البنية العامة

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

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

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

القيم المعادة

سلسلة نصية أو سلسلة حروف.

أمثلة

استخدام الدالة padStart()‎ مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة padStart()‎ عبرها مع تمرير عدد كوسيط، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "Hsoub" 

println(str.padStart(10)) // => "     Hsoub"
}

انظر أيضًا

• padEnd()‎: تعيد الدالة padEnd()‎ سلسلة نصية أو سلسلة حروف تساوي السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها ولكن مع تطويلها ليساوي طولها العدد المُمرّر length، التطويل يكون بإضافة الوسيط padChar إلى آخر السلسلة النصية أو سلسلة الحروف، وقيمتها الابتدائية هي المسافة البيضاء (space).
• isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

• صفحة الدالة padStart()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.