الفرق بين المراجعتين ل"Kotlin/collections/orEmpty"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>orEmpty()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>orEmpty()</code> في Kotlin}}</noinclude> |
| − | تعيد الدالة<code>orEmpty()</code> | + | <nowiki/><nowiki/>تعيد الدالة <code>orEmpty()</code> المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة <code>null</code>، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. |
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة <code>orEmpty()</code> | + | يمكن استدعاء الدالة <code>orEmpty()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]] و<nowiki/>[[Kotlin/List|القوائم]] والخرائط والمجموعات التي من النوع <code>[[Kotlin/Set|Set]]</code>:<syntaxhighlight lang="kotlin"> |
inline fun <reified T> Array<out T>?.orEmpty(): Array<out T> | inline fun <reified T> Array<out T>?.orEmpty(): Array<out T> | ||
| − | |||
| − | |||
inline fun <T> Collection<T>?.orEmpty(): Collection<T> | inline fun <T> Collection<T>?.orEmpty(): Collection<T> | ||
| − | |||
| − | |||
inline fun <T> List<T>?.orEmpty(): List<T> | inline fun <T> List<T>?.orEmpty(): List<T> | ||
| − | |||
inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) | inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) | ||
| − | |||
inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) | inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| − | ==القيم | + | ==القيم المعادة== |
| − | + | تُعاد المصفوفة أو المجموعة أو القائمة أو الخريطة المعطاة إن لم تكن مساويةً للقيمة <code>null</code>، أو يُعاد كائن فارغ يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. | |
==أمثلة== | ==أمثلة== | ||
| − | + | التأكد من عدم تساوي المصفوفة مع القيمة <code>null</code>:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val | + | val array1: Array<Any>? = null |
| − | + | val array2: Array<Char>? = arrayOf('a', 'b', 'c') | |
| − | + | ||
| − | + | println(array1.orEmpty().contentToString()) // [] | |
| − | + | println(array2.orEmpty().contentToString()) // [a, b, c] | |
| − | |||
| − | |||
| − | |||
| − | val | ||
| − | |||
| − | println( | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | ==انظر أيضًا== | |
| − | == | + | *الدالة <code>[[Kotlin/collections/none|none()]]</code>:تتحقق إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين. |
| − | * <code>[[Kotlin/collections/none|none()]]</code>: | + | * الدالة <code>[[Kotlin/collections/isNotEmpty|isNotEmpty()]]</code>: تعيد القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها غير فارغةً. |
| − | + | * الدالة <code>[[Kotlin/jvm/isArrayOf|isArrayOf()]]</code>: تتحقق من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد. | |
| − | == مصادر == | + | * الخاصية <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة. |
| − | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/or-empty.html الدالة | + | ==مصادر== |
| + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/or-empty.html صفحة الدالة orEmpty() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
مراجعة 16:43، 25 يوليو 2018
تعيد الدالة orEmpty() المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.
البنية العامة
يمكن استدعاء الدالة orEmpty() مع المصفوفات والمجموعات والقوائم والخرائط والمجموعات التي من النوع Set:
inline fun <reified T> Array<out T>?.orEmpty(): Array<out T>
inline fun <T> Collection<T>?.orEmpty(): Collection<T>
inline fun <T> List<T>?.orEmpty(): List<T>
inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source)
inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source)
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
القيم المعادة
تُعاد المصفوفة أو المجموعة أو القائمة أو الخريطة المعطاة إن لم تكن مساويةً للقيمة null، أو يُعاد كائن فارغ يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.
أمثلة
التأكد من عدم تساوي المصفوفة مع القيمة null:
fun main(args: Array<String>) {
val array1: Array<Any>? = null
val array2: Array<Char>? = arrayOf('a', 'b', 'c')
println(array1.orEmpty().contentToString()) // []
println(array2.orEmpty().contentToString()) // [a, b, c]
}
انظر أيضًا
- الدالة
none():تتحقق إن كانت المصفوفة أو المجموعة أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين. - الدالة
isNotEmpty(): تعيد القيمةtrueإن كانت المصفوفة التي استُدعيت عبرها غير فارغةً. - الدالة
isArrayOf(): تتحقق من حواية المصفوفة التي استُدعيت معها عناصرَ من نوعٍ محدَّد. - الخاصية
Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.