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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.all()‎ في لغة Kotlin}}</noinclude> يختلف سلوك الدالة <code>all()‎</code> بحسب نوع وعدد ا...'
 
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.all()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.all()‎</code> في Kotlin}}</noinclude>
يختلف سلوك الدالة <code>all()‎</code> بحسب نوع وعدد الوسائط المُمررة، انظر فقرة [[Kotlin/kotlin.text/String#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]].  
تتحقق الدالة <code>all()‎</code> إن كانت جميع محارف سلسلة معينة من المحارف محققةً لشرط معين.  


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun String(
inline fun CharSequence.all(
    bytes: ByteArray,
     predicate: (Char) -> Boolean
    offset: Int,
): Boolean
    length: Int,
</syntaxhighlight>
    charset: Charset
): String
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
تحول الدالة <code>String()‎</code> جزءًا من المصفوفة <code>bytes</code> (بداية من  العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) باستخدام مجموعة الحروف (character set) المُمرّرة <code>charset</code> وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String(bytes: ByteArray, charset: Charset): String
 
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
تحول الدالة <code>String()‎</code>  المصفوفة <code>bytes</code>باستخدام مجموعة الحروف (character set) المُمرّرة <code>charset</code> وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String(
     bytes: ByteArray,
    offset: Int,
    length: Int
): String
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
تحول الدالة <code>String()‎</code> جزءًا من المصفوفة <code>bytes</code> (بداية من  العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) باستخدام مجموعة الحروف  UTF-8 وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String(bytes: ByteArray): String
 
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
تحول الدالة <code>String()‎</code>  المصفوفة <code>bytes</code>  باستخدام مجموعة الحروف  UTF-8 وتعيد ناتج التحويل على شكل [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline actual fun String(chars: CharArray): String
 
 
</syntaxhighlight>تحول الدالة <code>String()‎</code> الحروف الموجودة في المصفوفة <code>chars</code> إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline actual fun String(
    chars: CharArray,
    offset: Int,
    length: Int
): String
</syntaxhighlight>تحول الدالة <code>String()‎</code>  الحروف الموجودة في المصفوفة <code>chars</code> (بداية من  العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String(
    codePoints: IntArray,
    offset: Int,
    length: Int
): String
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
تحول الدالة <code>String()‎</code>  نقاط الأكواد (code points) الموجودة في المصفوفة <code>codePoints</code> (بداية من  العنصر ذو الفهرس <code>offset</code> وبطولٍ يساوي <code>length</code>) إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String(stringBuffer: StringBuffer): String
 
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
 
تحول الدالة <code>String()‎</code>  محتويات الكائن المُمرّر  <code>stringBuffer</code> إلى [[Kotlin/String|سلسلة نصية]].<syntaxhighlight lang="kotlin">
inline fun String(stringBuilder: StringBuilder): String


</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
== المعاملات ==


تحول الدالة <code>String()‎</code> محتويات الكائن المُمرّر  <code>stringBuilder</code> إلى [[Kotlin/String|سلسلة نصية]].
=== <code>predicate</code> ===
دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة النصية المعطاة، إذ يمرر إليها محرفًا وتعيد لهذا المحرف قيمة منطقية.


== القيم المعادة ==
== القيم المعادة ==
[[Kotlin/String|سلسلة نصية]].
تعاد القيمة <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>
</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]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 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(): تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.

مصادر