الفرق بين المراجعتين ل"Kotlin/kotlin.text/filterTo"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.filterTo()</code> في لغة Kotlin}}</noinclude> تضيف الدالة <code>filterTo()</code> كل الحرو...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.filterTo()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.filterTo()</code> في لغة Kotlin}}</noinclude> | ||
− | تضيف الدالة <code>filterTo()</code> كل الحروف من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر <code>destination | + | تضيف الدالة <code>filterTo()</code> كل الحروف من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر <code>destination.</code> |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | inline fun <C> CharSequence. | + | inline fun <C> CharSequence.filterTo( |
destination: C, | destination: C, | ||
− | predicate: ( | + | predicate: (Char) -> Boolean |
− | ): C | + | ): C |
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
سطر 16: | سطر 16: | ||
تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، وتعرّف كائنا من الصنف [[Kotlin/kotlin.text/StringBuilder/index|<code>StringBuilder</code>]] باسم <code>sb</code>، ثمَّ تستدعي الدالة <code>()filterTo</code> عبرها مع تمرير <code>sb</code> ودالة منطقية كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، وتعرّف كائنا من الصنف [[Kotlin/kotlin.text/StringBuilder/index|<code>StringBuilder</code>]] باسم <code>sb</code>، ثمَّ تستدعي الدالة <code>()filterTo</code> عبرها مع تمرير <code>sb</code> ودالة منطقية كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | + | val str = "abcdef" | |
− | + | val sb = StringBuilder() | |
+ | |||
+ | str.filterTo (sb) {it<'c'} | ||
− | println( | + | println(sb) // ab |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | * <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]</code>: تعيد | + | * <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]</code>: تعيد الدالة <code>filterIndexed()</code> كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. |
+ | |||
+ | * <code>[[Kotlin/kotlin.text/filterIndexedTo|filterIndexedTo()]]</code>: تضيف الدالة <code>filterIndexedTo()</code> كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر <code>destination</code>. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. | ||
* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. | * <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. | ||
− | |||
− | |||
==مصادر== | ==مصادر== | ||
− | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/filter | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/filter-to.html الدالة text.filterTo() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 19:33، 8 يوليو 2018
تضيف الدالة filterTo()
كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي predicate
إلى الوسيط المُمرّر destination.
البنية العامة
inline fun <C> CharSequence.filterTo(
destination: C,
predicate: (Char) -> Boolean
): C
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
الوسيط المُمرّر destination
.
أمثلة
استخدام الدالة ()filterTo
مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str
، وتعرّف كائنا من الصنف StringBuilder
باسم sb
، ثمَّ تستدعي الدالة ()filterTo
عبرها مع تمرير sb
ودالة منطقية كوسيطين، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "abcdef"
val sb = StringBuilder()
str.filterTo (sb) {it<'c'}
println(sb) // ab
}
انظر أيضًا
filterIndexed()
: تعيد الدالةfilterIndexed()
كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()
ثم تعيد بدورها قيمة منطقيَّة.
filterIndexedTo()
: تضيف الدالةfilterIndexedTo()
كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقيpredicate
إلى الوسيط المُمرّرdestination
. يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()
ثم تعيد بدورها قيمة منطقيَّة.
elementAt()
: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException
.