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

المراجعة الحالية بتاريخ 05:53، 5 سبتمبر 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()‎: تحشو نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
الدالة prependIndent()‎: تضيف بادئة معينة إلى بداية كل سطر جديد في سلسلة نصية.
الدالة startsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
الدالة commonPrefixWith()‎: تعيد أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.padStart()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>padStart()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <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).
+تحشو الدالة <code>padStart()</code>‎ بداية [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.padEnd(
+fun CharSequence.padStart(
      length: Int,
      padChar: Char = ' '
 ): CharSequence
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+fun String.padStart(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/String|سلسلة نصية]]  أو [[Kotlin/CharSequence/index|سلسلة حروف]].
+تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إضافة المحرف <code>padChar</code> ذي حجم <code>length</code> إلى بدايتها.
 == أمثلة ==
+مثالٌ على استعمال الدالة <code>padStart()‎</code>:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>padStart()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>padStart()‎</code> عبرها مع تمرير عدد كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "Hsoub"
+    val str = "Hsoub"
-println(str.padEnd(10)) // => "Hsoub     "
+    println(str.padStart(10))      // => "     Hsoub"
+     println(str.padStart(10, 'w')) // => "wwwwwHsoub"
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/isNotEmpty|isNotEmpty()]]‎</code>: تعيد الدالة <code>isNotEmpty()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها غير فارغة.<code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+* الدالة <code>[[Kotlin/kotlin.text/padEnd|padEnd()]]‎</code>: تحشو نهاية [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة [[Kotlin/kotlin.text/prependIndent|<code>prependIndent()</code>‎]]: تضيف بادئة معينة إلى بداية كل سطر جديد في [[Kotlin/String|سلسلة نصية]].
+* الدالة <code>[[Kotlin/kotlin.text/startsWith|startsWith()]]‎</code>: تتحقق إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
+* الدالة <code>[[Kotlin/kotlin.text/codePointAt|commonPrefixWith()]]‎</code>: تعيد أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad-end.html صفحة الدالة padStart()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/pad-start.html صفحة الدالة padStart()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]