الفرق بين المراجعتين لصفحة: «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>‎ [[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>‎ بادئة معينة إلى بداية كل سطر جديد في [[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>
+== المعاملات ==
+=== <code>indent</code> ===
+سلسلة نصية تمثل البادئة المراد إضافتها إلى بداية كل سطر جديد في السلسلة النصية المعطاة. القيمة الافتراضية هي: <code>" "</code> (أي مسافة فارغة).
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 == القيم المعادة ==
-[[Kotlin/String|سلسلة نصية]]  أو [[Kotlin/CharSequence/index|سلسلة حروف]].
+تعاد [[Kotlin/String|سلسلة نصية]] تحوي [[Kotlin/String|السلسلة النصية]] المعطاة بعد إضافة البادئة <code>indent</code> إلى بداية كل سطر جديد فيها.
 == أمثلة ==
+مثالٌ على استعمال الدالة <code>prependIndent()‎</code>:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>prependIndent()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>prependIndent()‎</code> عبرها مع تمرير عدد كوسيط، ثم تطبع الناتج:<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="text">
+----hsoub
+----    academy
+----    wiki
 </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/pad-start.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]]