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

المراجعة الحالية بتاريخ 06:46، 2 سبتمبر 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
}

انظر أيضًا

الدالة append()‎ سلسلة المحارف الممررة إليها إلى الكائن الذي استُدعي معها.
الدالة any()‎: تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين.
الدالة String()‎: تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.all()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.all()‎</code> في Kotlin}}</noinclude>
-تعبد الدالة <code>all()‎</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 }
-ينشِئ التابع <code>ByteArray()‎</code> في الشيفرة الآتية مصفوفةً باسم <code>array</code> مكونة من عشرة عناصر ، ثم نمرر <code>array</code> إلى الدالة <code>all()‎</code>  لتحويل جزء منها إلى [[Kotlin/String|سلسلة نصية]]، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
+    println("evens.all { isEven(it) } is ${evens.all { isEven(it) }}") // true
-fun main(args: Array<String>) {
-val f: (Int) -> Byte = { x -> (x+97).toByte() }
-val array = ByteArray(10, f)
-val x = String(array, 2, 6)
-print(x) // cdefgh
+    val emptyList = emptyList<Int>()
+    println("emptyList.all { false } is ${emptyList.all { false }}") // true
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* صفحة الصنف <code>[[Kotlin/ByteArray/index|ByteArray]]</code>
+* الدالة <code>[[Kotlin/kotlin.text/append|append()‎]]</code> [[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها إلى الكائن الذي استُدعي معها.
+* الدالة <code>[[Kotlin/kotlin.text/any|any()]]‎</code>: تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*الدالة <code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.
-* الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string.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]]