الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/trimIndent»
< Kotlin | kotlin.text
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code> | <noinclude>{{DISPLAYTITLE: الدالة <code>trimIndent()</code> في Kotlin}}</noinclude> | ||
تبحث | تبحث الدالة <code>trimIndent()</code> عن أقل مسافة بادئة (minimal indent) مشتركة بين جميع أسطر [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها، ثم تحذفها من كل الأسطر، وتحذف أيضًا السطر الأول والأخير إن كانا فارغين (blanks)، أي مُكوّنان من مسافات بيضاء (whitespaces) فقط. | ||
الجذير بالذكر أن الأسطر الفارغة لا تؤثر في حساب أقل مسافة بادئة مشتركة بين جميع الأسطر. | |||
في حال كان هناك سطر غير | في حال كان هناك سطر غير فارغ ولا يوجد في بدايته أية مسافة بيضاء، فلن يكون هنالك حينئذٍ مسافة بيضاء مشتركة بين الأسطر؛أي أنَّ الدالة لن لن تجري أي تغيير على السلسلة النصية. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 11: | سطر 11: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
[[Kotlin/String|سلسلة نصية]]. | تعاد [[Kotlin/String|سلسلة نصية]] جديدة تحوي جميع محتويات السلسلة النصية المعطاة بعد إزالة أقل مسافة مشتركة بين جميع أسطرها، وإزالة السطر الأول والأخير إن كانا فارغين. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استعمال الدالة <code>()trimIndent</code><nowiki/>:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val withoutIndent = | val withoutIndent = | ||
""" | """ | ||
ABC | ABC | ||
123 | 123 | ||
456 | 456 | ||
""".trimIndent() | """.trimIndent() | ||
println(withoutIndent) // ABC\n123\n456 | println(withoutIndent) // ABC\n123\n456 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* | *الدالة <code>[[Kotlin/kotlin.text/trim|trim()]]</code>: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها. | ||
*الدالة <code>[[Kotlin/kotlin.text/trimEnd|trimEnd()]]</code>: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها. | |||
*الدالة <code>[[Kotlin/kotlin.text/trimStart|trimStart()]]</code>: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها. | |||
*الدالة <code>[[Kotlin/kotlin.text/trimMargin|trimMargin()]]</code>: تحذف جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين. | |||
* الدالة <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]</code>: تحذف بادئة معينة من <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] أو سلسلة نصية. | |||
* الدالة <code>[[Kotlin/kotlin.text/substringBeforeLast|substringBeforeLast()]]</code>: تجلب كل الجزء الواقع قبل آخر ظهور <nowiki/>[[Kotlin/Char|لمحرف]] أو لسلسلة نصية معينة في سلسلة نصية. | |||
* الدالة <code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith()]]</code>: تعيد أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها. | |||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/trim-indent.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/trim-indent.html الدالة trimIndent() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
المراجعة الحالية بتاريخ 12:55، 6 سبتمبر 2018
تبحث الدالة trimIndent() عن أقل مسافة بادئة (minimal indent) مشتركة بين جميع أسطر السلسلة النصية التي استُدعيت معها، ثم تحذفها من كل الأسطر، وتحذف أيضًا السطر الأول والأخير إن كانا فارغين (blanks)، أي مُكوّنان من مسافات بيضاء (whitespaces) فقط.
الجذير بالذكر أن الأسطر الفارغة لا تؤثر في حساب أقل مسافة بادئة مشتركة بين جميع الأسطر.
في حال كان هناك سطر غير فارغ ولا يوجد في بدايته أية مسافة بيضاء، فلن يكون هنالك حينئذٍ مسافة بيضاء مشتركة بين الأسطر؛أي أنَّ الدالة لن لن تجري أي تغيير على السلسلة النصية.
البنية العامة
fun String.trimIndent(): String
القيم المعادة
تعاد سلسلة نصية جديدة تحوي جميع محتويات السلسلة النصية المعطاة بعد إزالة أقل مسافة مشتركة بين جميع أسطرها، وإزالة السطر الأول والأخير إن كانا فارغين.
أمثلة
مثالٌ على استعمال الدالة ()trimIndent:
fun main(args: Array<String>) {
val withoutIndent =
"""
ABC
123
456
""".trimIndent()
println(withoutIndent) // ABC\n123\n456
}
انظر أيضًا
- الدالة
trim(): تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
- الدالة
trimEnd(): تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. - الدالة
trimStart(): تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها. - الدالة
trimMargin(): تحذف جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر السلسلة النصية التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين. - الدالة
removePrefix(): تحذف بادئة معينة من سلسلة من المحارف أو سلسلة نصية. - الدالة
substringBeforeLast(): تجلب كل الجزء الواقع قبل آخر ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. - الدالة
commonPrefixWith(): تعيد أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.