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

المراجعة الحالية بتاريخ 05:50، 5 سبتمبر 2018

تضيف الدالة prependIndent()‎ بادئة معينة إلى بداية كل سطر جديد في سلسلة نصية. هذه الدالة لا تحفظ نهايات الأسطر الأصلية.

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

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

المعاملات

`indent`

سلسلة نصية تمثل البادئة المراد إضافتها إلى بداية كل سطر جديد في السلسلة النصية المعطاة. القيمة الافتراضية هي: " " (أي مسافة فارغة).

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

تعاد سلسلة نصية تحوي السلسلة النصية المعطاة بعد إضافة البادئة indent إلى بداية كل سطر جديد فيها.

أمثلة

مثالٌ على استعمال الدالة prependIndent()‎:

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

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

ناتج تنفيذ هذه المثال هو:

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

انظر أيضًا

الدالة padStart()‎: تحشو بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
الدالة removePrefix()‎: تحذف بادئة معينة من سلسلة من المحارف أو سلسلة نصية.
الدالة startsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
الدالة commonPrefixWith()‎: تعيد أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.prependIndent()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>String.prependIndent()‎</code> في Kotlin}}</noinclude>
-تقوم الدالة <code>prependIndent()</code>‎ بزيادة البادئة المُمررة <code>indent</code> في بداية كل سطر جديد من [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
+تضيف الدالة <code>prependIndent()</code>‎ بادئة معينة إلى بداية كل سطر جديد في [[Kotlin/String|سلسلة نصية]]. هذه الدالة لا تحفظ نهايات الأسطر الأصلية.
-هذه الدالة لا تحفظ نهايات الأسطر الأصلية.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
@@ سطر 8: / سطر 6: @@
 </syntaxhighlight>
+== المعاملات ==
+=== <code>indent</code> ===
+سلسلة نصية تمثل البادئة المراد إضافتها إلى بداية كل سطر جديد في السلسلة النصية المعطاة. القيمة الافتراضية هي: <code>" "</code> (أي مسافة فارغة).
 == القيم المعادة ==
-[[Kotlin/String|سلسلة نصية]].
+تعاد [[Kotlin/String|سلسلة نصية]] تحوي [[Kotlin/String|السلسلة النصية]] المعطاة بعد إضافة البادئة <code>indent</code> إلى بداية كل سطر جديد فيها.
 == أمثلة ==
+مثالٌ على استعمال الدالة <code>prependIndent()‎</code>:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>prependIndent()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>prependIndent()‎</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = """hsoub
@@ سطر 22: / سطر 24: @@
      println(str.prependIndent("----"))
 }
-</syntaxhighlight>المُخرجات:<syntaxhighlight lang="kotlin">
+</syntaxhighlight>ناتج تنفيذ هذه المثال هو:<syntaxhighlight lang="text">
 ----hsoub
 ----    academy
@@ سطر 28: / سطر 30: @@
 </syntaxhighlight>
 == انظر أيضًا ==
-* <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/kotlin.text/padStart|padStart()]]‎</code>: تحشو بداية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]‎</code>: تحذف بادئة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].
+* الدالة <code>[[Kotlin/kotlin.text/startsWith|startsWith()]]‎</code>: تتحقق إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
+* الدالة <code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith()]]‎</code>: تعيد أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/prepend-indent.html صفحة الدالة text.prependIndent()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/prepend-indent.html صفحة الدالة String.prependIndent()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]