الدالة trimEnd()‎ في Kotlin

تحذف الدالة trimEnd()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.  

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

inline fun CharSequence.trimEnd(
    predicate: (Char) -> Boolean
): CharSequence

inline fun String.trimEnd(
    predicate: (Char) -> Boolean
): String

fun CharSequence.trimEnd(vararg chars: Char): CharSequence 

fun String.trimEnd(vararg chars: Char): String 

fun CharSequence.trimEnd(): CharSequence 

inline fun String.trimEnd(): String

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

predicate

دالةٌ تطبق على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إليها كل محرف على حدة وتعيد القيمة المنطقية المقابلة له.

chars

المحارف المراد حذفها من نهاية سلسلة المحارف أو السلسلة النصية المعطاة.

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

تعاد سلسلة من المحارف أو سلسلة نصية تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة باستثناء المحارف المحققة للشرط predicate، أو المحارف chars، أو المسافات الفارغة (إن لم يمرر أي معامل) الموجودة في نهايتها.

أمثلة

مثالٌ على استعمال الدالة ()trimEnd:

fun main(args: Array<String>) {
    println("    hsoub   ".trimEnd()) // "    hsoub"
    println("++++hsoub......".trimEnd { !it.isLetter() }) // ++++hsoub
}

انظر أيضًا

• الدالة trim()‎: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
• الدالة trimStart()‎: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
• الدالة trimIndent()‎: تبحث عن أقل مسافة بادئة (minimal indent) مشتركة بين جميع أسطر السلسلة النصية التي استُدعيت معها، ثم تحذفها من كل الأسطر، وتحذف أيضًا السطر الأول والأخير إن كانا فارغين.
• الدالة trimMargin()‎: تحذف جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر السلسلة النصية التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين.
• الدالة commonSuffixWith()‎: تعيد أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها
• الدالة removeSuffix()‎: تحذف لاحقة معينة من سلسلة من المحارف أو سلسلة نصية.
• الدالة padEnd()‎: تحشو نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.

مصادر

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