الفرق بين المراجعتين ل"Kotlin/collections/component1"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| (6 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>component1()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>component1()</code> في Kotlin}}</noinclude> |
| − | تعيد الدالة <code>component1()</code> العنصر الأول من المصفوفة | + | تعيد الدالة <code>component1()</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. |
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة <code>component1()</code> | + | يمكن استدعاء الدالة <code>component1()</code> مع المصفوفات والقوائم (list):<syntaxhighlight lang="kotlin"> |
inline operator fun <T> Array<out T>.component1(): T | inline operator fun <T> Array<out T>.component1(): T | ||
inline operator fun ByteArray.component1(): Byte | inline operator fun ByteArray.component1(): Byte | ||
| سطر 16: | سطر 16: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | ويمكن | + | ويمكن استدعاؤها مع الخرائط (maps):<syntaxhighlight lang="kotlin"> |
inline operator fun <K, V> Entry<K, V>.component1(): K | inline operator fun <K, V> Entry<K, V>.component1(): K | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]). |
==القيم المعادة== | ==القيم المعادة== | ||
| − | العنصر الأول من المصفوفة | + | يُعاد العنصر الأول من المصفوفة أو قيمة المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. |
==أمثلة== | ==أمثلة== | ||
| − | + | استخدام الدالة <code>()component1</code> مع القوائم:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val list = listOf('a', 'b', 'c', 'd', 'e') | + | val list = listOf('a', 'b', 'c', 'd', 'e') |
| − | println(list.component1()) // a | + | println(list.component1()) // a |
} | } | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>استخدام الدالة <code>()component1</code> مع الخرائط:<syntaxhighlight lang="kotlin"> |
| − | |||
| − | |||
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val map = hashMapOf("foo" to 1, "bar" to 2) | + | val map = hashMapOf("foo" to 1, "bar" to 2) |
| − | for (x | + | for (x in map) { |
| − | + | println(x.component1()) // bar foo | |
| − | } | + | } |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *<code>[[Kotlin/collections/associate|associate()]]</code>: تعيد | + | *الدالة <code>[[Kotlin/collections/associate|associate()]]</code>: تعيد خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفة أو مجموعة ([[Kotlin/collections|Collection]]) إلى الدالة <code>()transform</code>. |
| + | * الدالة <code>[[Kotlin/collections/asList|asList()]]</code>: تعيد قائمة تُغلّف المصفوفة الأصليَّة. | ||
| + | *الدالة <code>[[Kotlin/collections/contains|contains()]]</code>: تتحقق إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). | ||
| + | *الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة. | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/component1.html الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/component1.html صفحة الدالة component1() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Collection]] | ||
المراجعة الحالية بتاريخ 07:27، 8 سبتمبر 2018
تعيد الدالة component1() العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط.
البنية العامة
يمكن استدعاء الدالة component1() مع المصفوفات والقوائم (list):
inline operator fun <T> Array<out T>.component1(): T
inline operator fun ByteArray.component1(): Byte
inline operator fun ShortArray.component1(): Short
inline operator fun IntArray.component1(): Int
inline operator fun LongArray.component1(): Long
inline operator fun FloatArray.component1(): Float
inline operator fun DoubleArray.component1(): Double
inline operator fun BooleanArray.component1(): Boolean
inline operator fun CharArray.component1(): Char
inline operator fun <T> List<T>.component1(): T
ويمكن استدعاؤها مع الخرائط (maps):
inline operator fun <K, V> Entry<K, V>.component1(): K
وجود الكلمة المفتاحية inline تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).
القيم المعادة
يُعاد العنصر الأول من المصفوفة أو قيمة المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها.
أمثلة
استخدام الدالة ()component1 مع القوائم:
fun main(args: Array<String>) {
val list = listOf('a', 'b', 'c', 'd', 'e')
println(list.component1()) // a
}
استخدام الدالة ()component1 مع الخرائط:
fun main(args: Array<String>) {
val map = hashMapOf("foo" to 1, "bar" to 2)
for (x in map) {
println(x.component1()) // bar foo
}
}
انظر أيضًا
- الدالة
associate(): تعيد خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر مصفوفة أو مجموعة (Collection) إلى الدالة()transform. - الدالة
asList(): تعيد قائمة تُغلّف المصفوفة الأصليَّة. - الدالة
contains(): تتحقق إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). - الخاصيّة
Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.