الفرق بين المراجعتين ل"Kotlin/kotlin.text/padStart"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.padStart() في لغة Kotlin}}</noinclude> تعيد الدالة <code>padStart()</code> Kotlin/String|سلسلة...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع text.padStart() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع text.padStart() في لغة Kotlin}}</noinclude> | ||
| − | تعيد الدالة <code>padStart()</code> [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] تساوي [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها ولكن مع تطويلها ليساوي طولها العدد المُمرّر <code>length</code>، التطويل يكون بإضافة الوسيط <code>padChar</code> إلى | + | تعيد الدالة <code>padStart()</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"> | <syntaxhighlight lang="kotlin"> | ||
| − | fun CharSequence. | + | fun CharSequence.padStart( |
length: Int, | length: Int, | ||
padChar: Char = ' ' | padChar: Char = ' ' | ||
): CharSequence | ): CharSequence | ||
| + | |||
| + | fun String.padStart(length: Int, padChar: Char = ' '): String | ||
| + | |||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
== القيم المعادة == | == القيم المعادة == | ||
| سطر 18: | سطر 21: | ||
val str = "Hsoub" | val str = "Hsoub" | ||
| − | println(str. | + | println(str.padStart(10)) // => " Hsoub" |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * <code>[[Kotlin/kotlin.text/ | + | * <code>[[Kotlin/kotlin.text/padEnd|padEnd()]]</code>: تعيد الدالة <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). |
* <code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode). | * <code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode). | ||
== مصادر == | == مصادر == | ||
| − | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad- | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad-start.html صفحة الدالة padStart() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 21:45، 10 يوليو 2018
تعيد الدالة 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).