الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/padEnd»
< Kotlin | kotlin.text
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE: الدالة <code>padEnd()</code> في Kotlin}}</noinclude> | ||
تحشو الدالة <code>padEnd()</code> نهاية [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 7: | سطر 7: | ||
padChar: Char = ' ' | padChar: Char = ' ' | ||
): CharSequence | ): CharSequence | ||
fun String.padEnd(length: Int, padChar: Char = ' '): String | |||
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | |||
== المعاملات == | |||
=== <code>length</code> === | |||
طول اللاحقة المراد ملؤها بالمحرف <code>padChar</code>. | |||
=== <code>padChar</code> === | |||
المحرف المراد إضافته إلى نهاية سلسلة من المحارف أو سلسلة نصية. القيمة الافتراضية له هي: <code>' '</code> (أي محرف المسافة). | |||
==القيم المعادة== | |||
تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إضافة المحرف <code>padChar</code> ذي حجم <code>length</code> إلى نهايتها. | |||
== أمثلة == | == أمثلة == | ||
مثالٌ على استعمال الدالة <code>padEnd()</code>:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "Hsoub" | val str = "Hsoub" | ||
println(str.padEnd(10)) // => "Hsoub " | println(str.padEnd(10)) // => "Hsoub " | ||
println(str.padEnd(10, 'w')) // => "Hsoubwwwww" | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* <code>[[Kotlin/kotlin.text/padStart|padStart()]]</code>: | * الدالة <code>[[Kotlin/kotlin.text/padStart|padStart()]]</code>: تحشو بداية [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد. | ||
== مصادر == | == مصادر == | ||
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad-end.html صفحة الدالة padEnd() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad-end.html صفحة الدالة padEnd() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
مراجعة 16:54، 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(): تحشو بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.