الفرق بين المراجعتين ل"Kotlin/jvm/isArrayOf"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة isArrayOf()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة isArrayOf()‎ في Kotlin}}</noinclude>
تتحقق الدالة <code>isArrayOf()‎</code> من أنّ [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها يمكن أن تحتوي عناصر من النوع المحدد.
+
تتحقَّق الدالة <code>isArrayOf()‎</code> من حواية [[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
 
fun <reified T : Any> Array<*>.isArrayOf(): Boolean
 
fun <reified T : Any> Array<*>.isArrayOf(): Boolean
</syntaxhighlight>يلاحظ أيضًا استخدام الكلمة المفتاحية <code>reified</code> للتمكّن من الوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (parameter)، راجع <nowiki/>[[Kotlin/inline functions#.D8.A7.D9.84.D9.85.D8.AA.D8.AD.D9.88.D9.91.D9.84.D8.A7.D8.AA .D9.85.D9.86 .D8.A7.D9.84.D9.86.D9.88.D8.B9 reified.C2.A0|توثيق reified]].
+
</syntaxhighlight>يدل استخدام الكلمة المفتاحية <code>[[Kotlin/inline functions#.D8.A7.D9.84.D9.85.D8.AA.D8.AD.D9.88.D9.91.D9.84.D8.A7.D8.AA .D9.85.D9.86 .D8.A7.D9.84.D9.86.D9.88.D8.B9 reified.C2.A0|reified]]</code> على إمكانية الوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (راجع <nowiki/>[[Kotlin/inline functions#.D8.A7.D9.84.D9.85.D8.AA.D8.AD.D9.88.D9.91.D9.84.D8.A7.D8.AA .D9.85.D9.86 .D8.A7.D9.84.D9.86.D9.88.D8.B9 reified.C2.A0|توثيق reified]] للمزيد من التفاصيل).
 
== القيم المعادة ==
 
== القيم المعادة ==
قيمة منطقية تحدد إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها الدالة يمكن أن تحتوي عناصر من النوع المحدد.
+
تُعاد القيمة المنطقية <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] المعطاة تحوي النوع المعطى أو القيمة <code>false</code> خلاف ذلك.
 
== أمثلة ==
 
== أمثلة ==
  
=== استخدام الدالة<code>isArrayOf()‎</code> على مصفوفة: الحالة الأولى ===
+
=== استخدام الدالة <code>isArrayOf()‎</code> مع مصفوفة: حالة مطابقة النوع المعطى ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>numbers</code> مكونة من ستة أعداد باستخدام الدالة <code>()Array<Int>‎</code>، ثم تستخدم الدالة  <code>()isArrayOf</code>  للتحقق من أنّ المصفوفة <code>numbers</code> يمكن أن تحتوي عناصر من النوع <code>Int</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>numbers</code> مكونة من ستة أعداد باستخدام الدالة <code>()Array</code> ثمَّ تستخدم الدالة  <code>()isArrayOf</code>  للتحقق من احتواء تلك المصفوفة على أعداد صحيحة (Integer):<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
var numbers = Array<Int>(6, { i -> i })
+
    var numbers = Array(6) { i -> i }
      
+
 
println(numbers.isArrayOf<Int>())// true
+
     println(numbers.isArrayOf<Int>())// true
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
=== استخدام الدالة<code>indexOfFirst()‎</code> على مصفوفة: الحالة الثانية ===
+
=== استخدام الدالة <code>isArrayOf()‎</code> مع مصفوفة: حالة عدم مطابقة النوع المعطى ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>numbers</code> مكونة من ستة أعداد باستخدام الدالة <code>()Array<Int>‎</code>، ثم تستخدم الدالة  <code>()isArrayOf</code>  للتحقق من أنّ المصفوفة <code>numbers</code> يمكن أن تحتوي عناصر من النوع <code>String</code>، ثم تطبع الناتج:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>numbers</code> باستخدام الدالة <code>()Array<Int>‎</code> ثمَّ تستخدم الدالة <code>()isArrayOf</code> للتحقُّق من احتواء تلك المصفوفة على سلاسل نصية (String):<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
var numbers = Array<Int>(6, { i -> i })
+
    var numbers = Array(6) { i -> i }
      
+
 
println(numbers.isArrayOf<String>())// false
+
     println(numbers.isArrayOf<String>())// false
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* <code>[[Kotlin/collections/isEmpty|isEmpty]]()‎</code>: تعيد <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استدعيت عبرها فارغة.
+
* الدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>: تتحقَّق إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا.
 +
* الدالة <code>[[Kotlin/collections/all|all()‎]]</code>: تتحقق إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت معها تطابق شرطًا محدَّدًا.
  
 
== مصادر ==
 
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.jvm/is-array-of.html الدالة isArrayOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.jvm/is-array-of.html صفحة الدالة isArrayOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

مراجعة 14:09، 24 يوليو 2018

تتحقَّق الدالة isArrayOf()‎ من حواية المصفوفة التي استُدعيت معها عناصرَ من نوعٍ محدَّد.

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

fun <reified T : Any> Array<*>.isArrayOf(): Boolean

يدل استخدام الكلمة المفتاحية reified على إمكانية الوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (راجع توثيق reified للمزيد من التفاصيل).

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

تُعاد القيمة المنطقية true إن كانت المصفوفة المعطاة تحوي النوع المعطى أو القيمة false خلاف ذلك.

أمثلة

استخدام الدالة isArrayOf()‎ مع مصفوفة: حالة مطابقة النوع المعطى

تعرف الشيفرة الآتية مصفوفة باسم numbers مكونة من ستة أعداد باستخدام الدالة ()Array ثمَّ تستخدم الدالة  ()isArrayOf  للتحقق من احتواء تلك المصفوفة على أعداد صحيحة (Integer):

fun main(args: Array<String>) {
    var numbers = Array(6) { i -> i }

    println(numbers.isArrayOf<Int>())// true
}

استخدام الدالة isArrayOf()‎ مع مصفوفة: حالة عدم مطابقة النوع المعطى

تعرف الشيفرة الآتية مصفوفة باسم numbers باستخدام الدالة ()Array<Int>‎ ثمَّ تستخدم الدالة ()isArrayOf للتحقُّق من احتواء تلك المصفوفة على سلاسل نصية (String):

fun main(args: Array<String>) {
    var numbers = Array(6) { i -> i }

    println(numbers.isArrayOf<String>())// false
}

انظر أيضًا

  • الدالة isEmpty()‎: تتحقَّق إن كانت المصفوفة التي استُدعيت معها فارغةً أم لا.
  • الدالة all()‎: تتحقق إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت معها تطابق شرطًا محدَّدًا.

مصادر