الفرق بين المراجعتين ل"Kotlin/kotlin.text/prependIndent"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.prependIndent()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>prependIndent()</code>‎ Kotlin/String|س...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع text.prependIndent()‎ في لغة Kotlin}}</noinclude>
 
<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">
 
<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> مع السلاسل النصية ===
 
=== استخدام الدالة <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>) {
 
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>
 
</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]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 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

انظر أيضًا

مصادر