الفرق بين المراجعتين لصفحة: «Kotlin/jvm/isArrayOf»

من موسوعة حسوب
لا ملخص تعديل
طلا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة isArrayOf()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>isArrayOf()‎</code> في 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> خلاف ذلك.
== أمثلة ==
== أمثلة ==
مثالٌ<nowiki/> على استعمال الدالة  <code>()isArrayOf</code>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    var numbers = Array(6) { i -> i }


=== استخدام الدالة<code>isArrayOf()‎</code> على مصفوفة: الحالة الأولى ===
    println(numbers.isArrayOf<Int>()) // true
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>numbers</code> مكونة من ستة أعداد باستخدام الدالة <code>()Array<Int>‎</code>، ثم تستخدم الدالة  <code>()isArrayOf</code>  للتحقق من أنّ المصفوفة <code>numbers</code> يمكن أن تحتوي عناصر من النوع <code>Int</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
     println(numbers.isArrayOf<String>()) // false
fun main(args: Array<String>) {
var numbers = Array<Int>(6, { i -> i })
      
println(numbers.isArrayOf<Int>())// true
}
}
</syntaxhighlight>
</syntaxhighlight>


=== استخدام الدالة<code>indexOfFirst()‎</code> على مصفوفة: الحالة الثانية ===
== <nowiki/><nowiki/><nowiki/>انظر أيضًا ==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>numbers</code> مكونة من ستة أعداد باستخدام الدالة <code>()Array<Int>‎</code>، ثم تستخدم الدالة  <code>()isArrayOf</code>  للتحقق من أنّ المصفوفة <code>numbers</code> يمكن أن تحتوي عناصر من النوع <code>String</code>، ثم تطبع الناتج:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
* الدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>: تتحقَّق إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا.
fun main(args: Array<String>) {
* الدالة <code>[[Kotlin/collections/all|all()‎]]</code>: تتحقق إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت معها تطابق شرطًا محدَّدًا.
var numbers = Array<Int>(6, { i -> i })
* الدالة <code>[[Kotlin/collections/none|none()]]</code>: تتحقق إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
   
println(numbers.isArrayOf<String>())// false
}
</syntaxhighlight>
== انظر أيضًا ==
* <code>[[Kotlin/collections/isEmpty|isEmpty]]()‎</code>: تعيد <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استدعيت عبرها فارغة.


== مصادر ==
== مصادر ==
* [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 Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 08:33، 8 سبتمبر 2018

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

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

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

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

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

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

أمثلة

مثالٌ على استعمال الدالة  ()isArrayOf:

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

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

انظر أيضًا

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

مصادر