الفرق بين المراجعتين ل"Kotlin/kotlin.text/mapNotNull"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.) |
|||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.mapNotNull()</code> في Kotlin}}</noinclude> |
| − | تعيد | + | تعيد الدالة <code>mapNotNull()</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 6: | سطر 6: | ||
transform: (Char) -> R? | transform: (Char) -> R? | ||
): List<R> | ): List<R> | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>transform</code> === | ||
| + | دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها محرفٌ وتعيد القيمة المقابلة له. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| − | [[Kotlin/ | + | تُعاد قائمةٌ تضم ناتج تطبيق الدالة <code>transform</code> المعطاة على كل عنصر من عناصر محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة أيضًا باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. |
==أمثلة== | ==أمثلة== | ||
| − | + | مثالٌ على استعمال الدالة <code>mapNotNull()</code>:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val str = "Hsoub Wiki" | + | val str = "Hsoub Wiki" |
| − | + | ||
| − | print( str.mapNotNull { if (it.isUpperCase() ) it else null} ) // [H, W] | + | print(str.mapNotNull { if (it.isUpperCase()) it else null }) // [H, W] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *<code>[[Kotlin/kotlin.text/ | + | *الدالة <code>[[Kotlin/kotlin.text/mapNotNullTo|mapNotNullTo()]]</code>: تشبه الدالة <code>mapNotNull()</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. |
| − | *<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]] | + | *الدالة <code>[[Kotlin/kotlin.text/map|map()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. |
| − | + | *الدالة <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. | |
| − | * <code>[[Kotlin/kotlin.text/ | + | *الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. |
| + | * الدالة <code>[[Kotlin/kotlin.text/filterNot|filterNot()]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي لم تحقِّق شرطًا معيَّنًا. | ||
==مصادر== | ==مصادر== | ||
| − | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-not-null.html صفحة الدالة | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-not-null.html صفحة الدالة CharSequence.mapNotNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Text]] | ||
| + | [[تصنيف:Kotlin CharSequence]] | ||
المراجعة الحالية بتاريخ 10:12، 4 سبتمبر 2018
تعيد الدالة mapNotNull() قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
البنية العامة
inline fun <R : Any> CharSequence.mapNotNull(
transform: (Char) -> R?
): List<R>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).
المعاملات
transform
دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها محرفٌ وتعيد القيمة المقابلة له.
القيم المعادة
تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform المعطاة على كل عنصر من عناصر محرف من محارف السلسلة المعطاة أيضًا باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
أمثلة
مثالٌ على استعمال الدالة mapNotNull():
fun main(args: Array<String>) {
val str = "Hsoub Wiki"
print(str.mapNotNull { if (it.isUpperCase()) it else null }) // [H, W]
}
انظر أيضًا
- الدالة
mapNotNullTo(): تشبه الدالةmapNotNull()تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. - الدالة
map(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها. - الدالة
mapIndexed(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها. - الدالة
mapIndexedNotNull(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّةnullالتي تعيدها تلك الدالة. - الدالة
filterNot(): ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي لم تحقِّق شرطًا معيَّنًا.