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

مراجعة 19:05، 10 يوليو 2018

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

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

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

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

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

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

أمثلة

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

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

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

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

انظر أيضًا

isNotEmpty()‎: تعيد الدالة isNotEmpty()‎ القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها غير فارغة.isHighSurrogate()‎: تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.padEnd()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>padEnd()</code>‎  [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها إن لم تكن معدومة (not-null)، وإلا فستعيد [[Kotlin/String|سلسلة نصية]] فارغة.
+تعيد الدالة <code>padEnd()</code>‎ [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] تساوي  [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها ولكن مع تطويلها ليساوي طولها العدد المُمرّر <code>length</code>، التطويل يكون بإضافة الوسيط <code>padChar</code> إلى آخر  [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]]، وقيمتها الابتدائية هي المسافة البيضاء (space).
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-inline fun String?.orEmpty(): String
+fun CharSequence.padEnd(
+    length: Int,
+    padChar: Char = ' '
+): CharSequence
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 == القيم المعادة ==
-[[Kotlin/String|سلسلة نصية]].
+[[Kotlin/String|سلسلة نصية]]  أو [[Kotlin/CharSequence/index|سلسلة حروف]].
 == أمثلة ==
 === استخدام الدالة <code>padEnd()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>padEnd()‎</code> عبرها وعبر القيمة المعدومة <code>null</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>padEnd()‎</code> عبرها مع تمرير عدد كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val str = "Hsoub"
-println(str.orEmpty()) // Hsoub
+println(str.padEnd(10)) // => "Hsoub     "
-println(null.orEmpty()) // تعيد سلسلة نصية فارغة
 }
 </syntaxhighlight>
@@ سطر 25: / سطر 26: @@
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/or-empty.html صفحة الدالة padEnd()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad-end.html صفحة الدالة padEnd()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]