الدالة text.trimMargin() في لغة Kotlin
< Kotlin | kotlin.text
تبحث الدالة trimMargin() عن إزاحة دنوية (minimal indent) مشتركة بين جميع أسطر السلسلة النصية التي استُدعيت عبرها، ثم تمحوها من كل الأسطر، كما تمحو السطر الأول والأخير إن كانا بيضاوين (blanks)، أي مُكوّنان من مسافات بيضاء (whitespaces).
تذكّر أن الأسطر البيضاء لا تؤثر في رصد الإزاحة الدنوية.
في حال كان هناك سطر غير أبيض وليس في بدايته مسافات بيضاء، حينها ستكون الإزاحة الدنوية معدومة، وهذا يعني أنّ الدالة لن تغير الإزاحة.
البنية العامة
fun String.trimIndent(): String
القيم المعادة
أمثلة
استخدام الدالة ()trimMargin مع سلسلة نصية
تستدعي الشيفرة الآتية الدالة ()trimMargin عبر سلسلة نصية وتمرّر القيمة المُعادة إلى المتغير withoutIndent، ثم تطبع الناتج:
fun main(args: Array<String>) {
val withoutIndent =
"""
ABC
123
456
""".trimIndent()
println(withoutIndent) // ABC\n123\n456
}
انظر أيضًا
trimEnd(): تعيد الدالةtrimEnd()جزءًا من سلسلة الحروف التي استُدعيت عبرها بعد حذف الأحرف الأخيرة التي تحقق الشرط المنطقي المُحدّدpredicate.trim(): تعيد الدالةtrim()جزءًا من سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها بعد حذف الأحرف الأولى والأخيرالتي تحقق الشرط المنطقي المُحدّدpredicate.
substringAfter(): تعيد الدالةsubstringAfter()جزءًا من السلسلة النصية التي استُدعيت عبرها والمُتواجد بعد أول ظهور للمُحدِّدdelimiter،إن لم تكن السلسلة النصية الأصلية تحتويdelimiter، فستعيد القيمة المُمرّرةmissingDelimiterValue، والتي قيمتها الافتراضية هي السلسلة النصية الأصلية.substringBefore(): تعيد الدالةsubstringBefore()جزءًا من السلسلة النصية التي استُدعيت عبرها والمُتواجد قبل أول ظهور للمُحدِّدdelimiter،إن لم تكن السلسلة النصية الأصلية تحتويdelimiter، فستعيد القيمة المُمرّرةmissingDelimiterValue، والتي قيمتها الافتراضية هي السلسلة النصية الأصلية.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.slice(): تعيد الدالةslice()سلسلة حروف أو سلسلة نصية جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.