الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/all»

مراجعة 15:47، 1 سبتمبر 2018

تتحقق الدالة all()‎ إن كانت جميع محارف سلسلة معينة من المحارف محققةً لشرط معين.

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

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

المعاملات

`predicate`

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

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

تعاد القيمة true إن كانت جميع محارف سلسلة المحارف المعطاة محققةً للشرط المحدد في المعامل predicate، أو تعاد القيمة false خلاف ذلك.

أمثلة

استعمال الدالة all()‎ للتحقق إن كانت جميع محارف سلسلة المحارف المعطاة محققةً لشرط معين:

fun main(args: Array<String>) {
    val isEven: (Int) -> Boolean = { it % 2 == 0 }
    val zeroToTen = 0..10
    println("zeroToTen.all { isEven(it) } is ${zeroToTen.all { isEven(it) }}") // false
    println("zeroToTen.all(isEven) is ${zeroToTen.all(isEven)}") // false

    val evens = zeroToTen.map { it * 2 }
    println("evens.all { isEven(it) } is ${evens.all { isEven(it) }}") // true

    val emptyList = emptyList<Int>()
    println("emptyList.all { false } is ${emptyList.all { false }}") // true
}

انظر أيضًا

الدالة any()‎: تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين.
String()‎: تحو المصفوفة الممررة إلى سلسلة نصية.

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

الخاصية indices: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

مصادر

صفحة الدالة CharSequence.all()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.all()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.all()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+تتحقق الدالة <code>all()‎</code> إن كانت جميع محارف سلسلة معينة من المحارف محققةً لشرط معين.
 == البنية العامة ==
@@ سطر 8: / سطر 8: @@
 ): Boolean
 </syntaxhighlight>
+== المعاملات ==
+=== <code>predicate</code> ===
+دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية المعطاة، إذ يمرر إليها محرفًا وتعيد لهذا المحرف قيمة منطقية.
 == القيم المعادة ==
-[[Kotlin/Boolean/index|قيمة منطقية]].
+تعاد القيمة <code>true</code> إن كانت جميع محارف سلسلة المحارف المعطاة محققةً للشرط المحدد في المعامل <code>predicate</code>، أو تعاد القيمة <code>false</code> خلاف ذلك.
 == أمثلة ==
+استعمال الدالة <code>all()‎</code> للتحقق إن كانت جميع محارف سلسلة المحارف المعطاة محققةً لشرط معين:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val isEven: (Int) -> Boolean = { it % 2 == 0 }
+    val zeroToTen = 0..10
+    println("zeroToTen.all { isEven(it) } is ${zeroToTen.all { isEven(it) }}") // false
+    println("zeroToTen.all(isEven) is ${zeroToTen.all(isEven)}") // false
-=== استخدام الدالة<code>all()‎</code>  ===
+    val evens = zeroToTen.map { it * 2 }
-تعرّف الشيفرة التالية دالة منطقية f لاختبار إن كانت الحروف كبيرة، كما تعرف  [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة<code>all()‎</code>  عبرهما، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
+    println("evens.all { isEven(it) } is ${evens.all { isEven(it) }}") // true
-fun main(args: Array<String>) {
-val f: (Char) -> Boolean = { it.isUpperCase() }
-val str = "Hsoub"
-val str2 = "HSOUB"
-println(str.all(f)) // false
+    val emptyList = emptyList<Int>()
-println(str2.all(f)) // true
+    println("emptyList.all { false } is ${emptyList.all { false }}") // true
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/any|any()]]‎</code>: تعيد الدالة <code>any()‎</code> القيمة <code>true</code>  إن كان هناك حرف واحد على الأقل يحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+* الدالة <code>[[Kotlin/kotlin.text/any|any()]]‎</code>: تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين.
 * <code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
@@ سطر 34: / سطر 41: @@
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/all.html الدالة text.all()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/all.html صفحة الدالة CharSequence.all()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]