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

مراجعة 22:12، 10 يوليو 2018

تقوم الدالة prependIndent()‎ بزيادة البادئة المُمررة indent في بداية كل سطر جديد من السلسلة النصية التي استٌدعيت عبرها.

هذه الدالة لا تحفظ نهايات الأسطر الأصلية.

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

fun String.prependIndent(indent: String = " "): String

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

سلسلة نصية.

أمثلة

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

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

fun main(args: Array<String>) {
    val str = """hsoub
    academy
    wiki"""

    println(str.prependIndent("----")) 
}

المُخرجات:

----hsoub
----    academy
----    wiki

انظر أيضًا

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

مصادر

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

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