الدالة text.replaceIndentByMargin()‎ في لغة Kotlin

تعيد الدالة replaceIndentByMargin()‎ سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الإزاحة (indent) المُحددة بواسطة marginPrefix بالسلسلة النصية newIndent.

marginPrefixهي سلسلة نصية لا تحتوي المسافات البيضاء فقط، وقيمتها الابتدائية "|".

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

fun String.replaceIndentByMargin(
    newIndent: String = "", 
    marginPrefix: String = "|"
): String

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

سلسلة نصية.

أمثلة

استخدام الدالة ()replaceIndentByMargin مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()replaceIndentByMargin عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "		Hsoub" 
    
println( str.replaceIndentByMargin ("....") ) // ....Hsoub
}

انظر أيضًا

• replace()‎:تعيد سلسلة نصية جديدة مع استبدال جزء من السلسلة النصية الأصلية.

• replaceBefore()‎: تعيد الدالة replaceBefore()‎ سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الجزء الذي يظهر قبل الوسيط المُمرّر delimiter بالسلسلة النصية replacement. إن لم لم تحتو السلسلة النصية على delimiter فستعيد missingDelimiterValue والذي يساوي افتراضيا السلسلة النصية الأصلية. 

• replaceIndent()‎: تعيد الدالة replaceIndent()‎ سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الإزاحة (indent) الموجودة في بدايتها بالسلسلة النصية newIndent.  
• asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

• الدالة text.replaceIndentByMargin()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.