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