الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/padEnd»

المراجعة الحالية بتاريخ 16:59، 4 سبتمبر 2018

تحشو الدالة padEnd()‎ نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.

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

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

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

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

المعاملات

`length`

طول اللاحقة المراد ملؤها بالمحرف padChar.

`padChar`

المحرف المراد إضافته إلى نهاية سلسلة من المحارف أو سلسلة نصية. القيمة الافتراضية له هي: ' ' (أي محرف المسافة).

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

تعاد سلسلة من المحارف أو سلسلة نصية تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إضافة المحرف padChar ذي حجم length إلى نهايتها.

أمثلة

مثالٌ على استعمال الدالة padEnd()‎:

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

    println(str.padEnd(10))      // => "Hsoub     "
    println(str.padEnd(10, 'w')) // => "Hsoubwwwww"
}

انظر أيضًا

الدالة padStart()‎: تحشو بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
الدالة endsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
الدالة commonSuffixWith()‎: تعيد أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

مصادر

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

@@ سطر 32: / سطر 32: @@
 == انظر أيضًا ==
 * الدالة <code>[[Kotlin/kotlin.text/padStart|padStart()]]‎</code>: تحشو بداية [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
+* الدالة <code>[[Kotlin/kotlin.text/endsWith|endsWith()]]‎</code>: تتحقق إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
 * الدالة <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith()]]‎</code>: تعيد أطول لاحقة (Suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.