الفرق بين المراجعتين ل"Kotlin/kotlin.text/trimStart"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function') |
جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.) |
||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code> | + | <noinclude>{{DISPLAYTITLE: الدالة <code>trimStart()</code> في Kotlin}}</noinclude> |
| − | + | تحذف الدالة <code>trimStart()</code> المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| − | inline fun CharSequence. | + | inline fun CharSequence.trimStart( |
predicate: (Char) -> Boolean | predicate: (Char) -> Boolean | ||
): CharSequence | ): CharSequence | ||
| − | |||
inline fun String.trimStart(predicate: (Char) -> Boolean): String | inline fun String.trimStart(predicate: (Char) -> Boolean): String | ||
| − | |||
fun CharSequence.trimStart(vararg chars: Char): CharSequence | fun CharSequence.trimStart(vararg chars: Char): CharSequence | ||
| − | |||
fun String.trimStart(vararg chars: Char): String | fun String.trimStart(vararg chars: Char): String | ||
| − | |||
fun CharSequence.trimStart(): CharSequence | fun CharSequence.trimStart(): CharSequence | ||
| − | + | ||
inline fun String.trimStart(): String | inline fun String.trimStart(): String | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>predicate</code> === | ||
| + | دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة. يمرر إليها كل محرف على حدة وتعيد القيمة المنطقية المقابلة له. | ||
| − | + | === <code>chars</code> === | |
| + | المحارف المراد حذفها من بداية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| − | [[Kotlin/ | + | تعاد [[Kotlin/CharSequence/index|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة باستثناء المحارف المحققة للشرط <code>predicate</code>، أو المحارف <code>chars</code>، أو المسافات الفارغة (إن لم يمرر أي معامل) الموجودة في بدايتها. |
==أمثلة== | ==أمثلة== | ||
| − | + | مثالٌ على استعمال الدالة <code>()trimStart</code><nowiki/>:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
println(" hsoub ".trimStart()) // "hsoub " | println(" hsoub ".trimStart()) // "hsoub " | ||
| − | println( "++++hsoub......".trimStart {!it.isLetter()} ) // hsoub...... | + | println("++++hsoub......".trimStart { !it.isLetter() }) // hsoub...... |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | * | + | *الدالة <code>[[Kotlin/kotlin.text/trim|trim()]]</code>: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | * <code>[[Kotlin/kotlin.text/ | + | *الدالة <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 الدالة | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/trim-start.html الدالة trimStart() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
| + | [[تصنيف:Kotlin Text]] | ||
المراجعة الحالية بتاريخ 12:55، 6 سبتمبر 2018
تحذف الدالة trimStart() المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
البنية العامة
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
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
predicate
دالةٌ تطبق على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إليها كل محرف على حدة وتعيد القيمة المنطقية المقابلة له.
chars
المحارف المراد حذفها من بداية سلسلة المحارف أو السلسلة النصية المعطاة.
القيم المعادة
تعاد سلسلة من المحارف أو سلسلة نصية تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة باستثناء المحارف المحققة للشرط predicate، أو المحارف chars، أو المسافات الفارغة (إن لم يمرر أي معامل) الموجودة في بدايتها.
أمثلة
مثالٌ على استعمال الدالة ()trimStart:
fun main(args: Array<String>) {
println(" hsoub ".trimStart()) // "hsoub "
println("++++hsoub......".trimStart { !it.isLetter() }) // hsoub......
}
انظر أيضًا
- الدالة
trim(): تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
- الدالة
trimEnd(): تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
- الدالة
trimIndent(): تبحث عن أقل مسافة بادئة (minimal indent) مشتركة بين جميع أسطر السلسلة النصية التي استُدعيت معها، ثم تحذفها من كل الأسطر، وتحذف أيضًا السطر الأول والأخير إن كانا فارغين. - الدالة
trimMargin(): تحذف جميع المحارف البيضاء البادئة المتبوعة بقيمة محددة من جميع أسطر السلسلة النصية التي استُدعيت معها، كما تحذف السطر الأول والأخير إن كانا فارغين. - الدالة
removePrefix(): تحذف بادئة معينة من سلسلة من المحارف أو سلسلة نصية. - الدالة
substringBeforeLast(): تجلب كل الجزء الواقع قبل آخر ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. - الدالة
padStart(): تحشو بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد. - الدالة
commonSuffixWith(): تعيد أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.