عرض مصدر Kotlin/kotlin.text/trimStart

<noinclude>{{DISPLAYTITLE: الدالة <code>trimStart()‎</code> في Kotlin}}</noinclude>
تحذف الدالة <code>trimStart()‎</code> المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها.      
==البنية العامة==
<syntaxhighlight lang="kotlin">
inline fun CharSequence.trimStart(
    predicate: (Char) -> Boolean
): CharSequence 

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

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

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

fun CharSequence.trimStart(): CharSequence

inline fun String.trimStart(): String 

</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>predicate</code> ===
دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة. يمرر إليها كل محرف على حدة وتعيد القيمة المنطقية المقابلة له.

=== <code>chars</code> ===
المحارف المراد حذفها من بداية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة.

==القيم المعادة==
تعاد [[Kotlin/CharSequence/index|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة باستثناء المحارف المحققة للشرط <code>predicate</code>، أو المحارف <code>chars</code>، أو المسافات الفارغة (إن لم يمرر أي معامل) الموجودة في بدايتها.
==أمثلة==
مثالٌ على استعمال الدالة <code>()trimStart</code><nowiki/>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    println("    hsoub   ".trimStart()) // "hsoub   "
    println("++++hsoub......".trimStart { !it.isLetter() }) // hsoub......
}
</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/trimIndent|trimIndent()‎]]</code>: تبحث عن أقل مسافة بادئة (minimal indent) مشتركة بين جميع أسطر [[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/padStart|padStart()]]‎</code>: تحشو بداية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
* الدالة <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith()]]‎</code>: تعيد أطول لاحقة (Suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/trim-start.html الدالة trimStart()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]