الفرق بين المراجعتين لصفحة: «Kotlin/to»
< Kotlin
لا ملخص تعديل |
مراجعة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة to() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة to() في لغة Kotlin}}</noinclude> | ||
تنشئ الدالة to() | تنشئ الدالة <code>to()</code> عنصرًا من النوع <code>Pair</code> مكونًا من الكائن الذي استُدعي عبره والوسيط (argument) الذي مُرّر إليه، أي العنصر <code>that</code>. | ||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
infix fun <A, B> A.to(that: B): Pair<A, B> | infix fun <A, B> A.to(that: B): Pair<A, B> | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>infix</code> للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>infix</code> للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل <code>.</code> والأقواس <code>()</code> المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع [[Kotlin/functions#.D8.A7.D9.84.D8.AA.D8.AF.D9.88.D9.8A.D9.86 .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D9.91 .28Infix notation.29|توثيق التدوين الداخلي للدوال (infix functions)]]. | ||
== القيم المعادة == | == القيم المعادة == | ||
يعيد | يعيد عنصرًا من النوع <code>Pair</code> مكونًا من الكائن استُدعي عبره والوسيط (argument) الذي مُرّر إليه. | ||
== أمثلة == | == أمثلة == | ||
=== استخدام الدالة <code>to()</code> لإنشاء | === استخدام الدالة <code>to()</code> لإنشاء عنصر من النوع <code>Pair</code> === | ||
تُعرّف الشيفرة الآتية متغيرين <code>a</code> و <code>b</code> ثم تستخدم الدالة <code>to()</code> لإنشاء | تُعرّف الشيفرة الآتية متغيرين صحيحين <code>a</code> و <code>b</code> ثم تستخدم الدالة <code>to()</code> لإنشاء زوجٍ (<code>pair</code>) مكوَّنٍ منهما:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val a = 2 | val a = 2 | ||
| سطر 23: | سطر 23: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== استخدام الدالة <code>to()</code> في إنشاء | === استخدام الدالة <code>to()</code> في إنشاء عنصر من النوع <code>Map</code> === | ||
تنشئ الشيفرة الآتية | تنشئ الشيفرة الآتية عنصر <code>map</code> باستخدام الدالة <code>to()</code> (لاحظ أننا لم نستخدم النقطة والأقواس لأنّ الدالة <code>to</code> مُعرّفة بنمط التدوين الداخلي <code>[[Kotlin/functions#.D8.A7.D9.84.D8.AA.D8.AF.D9.88.D9.8A.D9.86 .D8.A7.D9.84.D8.AF.D8.A7.D8.AE.D9.84.D9.8A.D9.91 .28Infix notation.29|infix]]</code>)، إذ يُجرى التقابل ما بين القيم <code>1</code> و <code>2</code> و <code>-1</code> والقيم <code>x</code> و <code>y</code> و <code>zz</code> على الترتيب:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val map = mapOf(1 to "x", 2 to "y", -1 to "zz") | val map = mapOf(1 to "x", 2 to "y", -1 to "zz") | ||
| سطر 32: | سطر 32: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* | * الصنف [[kotlin/pair|Pair]]: يعبِّر عن النوع pair المُستخدَم للتعامل مع الأزواج. | ||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/to.html صفحة الدالة to() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/to.html صفحة الدالة to() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
مراجعة 01:03، 27 مايو 2018
تنشئ الدالة to() عنصرًا من النوع Pair مكونًا من الكائن الذي استُدعي عبره والوسيط (argument) الذي مُرّر إليه، أي العنصر that.
البنية العامة
infix fun <A, B> A.to(that: B): Pair<A, B>
يُلاحَظ وجود الكلمة المفتاحية infix للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع توثيق التدوين الداخلي للدوال (infix functions).
القيم المعادة
يعيد عنصرًا من النوع Pair مكونًا من الكائن استُدعي عبره والوسيط (argument) الذي مُرّر إليه.
أمثلة
استخدام الدالة to() لإنشاء عنصر من النوع Pair
تُعرّف الشيفرة الآتية متغيرين صحيحين a و b ثم تستخدم الدالة to() لإنشاء زوجٍ (pair) مكوَّنٍ منهما:
fun main(args: Array<String>) {
val a = 2
val b = 6
val pair = a.to(b)
println(pair) // (2, 6)
}
استخدام الدالة to() في إنشاء عنصر من النوع Map
تنشئ الشيفرة الآتية عنصر map باستخدام الدالة to() (لاحظ أننا لم نستخدم النقطة والأقواس لأنّ الدالة to مُعرّفة بنمط التدوين الداخلي infix)، إذ يُجرى التقابل ما بين القيم 1 و 2 و -1 والقيم x و y و zz على الترتيب:
fun main(args: Array<String>) {
val map = mapOf(1 to "x", 2 to "y", -1 to "zz")
println(map) // {1=x, 2=y, -1=zz}
}
انظر أيضًا
- الصنف Pair: يعبِّر عن النوع pair المُستخدَم للتعامل مع الأزواج.