الفرق بين المراجعتين لصفحة: «Kotlin/to»
< Kotlin
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة to() في لغة Kotlin}}</noinclude> يُنشئ التابع to() زوجًا (عنصر من النوع Pair) مكونًا...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة to() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة to() في لغة Kotlin}}</noinclude> | ||
تنشئ الدالة to() زوجًا (عنصر من النوع <code>Pair</code>) مكونًا من الكائن الذي استُدعي عبره والمعامل (argument) الذي مُرّر إليه، أي العنصر <code>that</code> (انظر إمضاء الدالة). | |||
== البنية العامة == | == البنية العامة == | ||
<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> للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع [[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)]]. | |||
يُلاحَظ وجود الكلمة المفتاحية infix للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخلي (Infix notation | |||
)، أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع [[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)]]. | |||
== القيم المعادة == | == القيم المعادة == | ||
يعيد زوجًا (عنصر من النوع Pair) مكونًا من الكائن الذي استدعاه والمعامل (argument) الذي مُرّر إليه. | يعيد زوجًا (عنصر من النوع <code>Pair</code>) مكونًا من الكائن الذي استدعاه والمعامل (argument) الذي مُرّر إليه. | ||
== أمثلة == | == أمثلة == | ||
=== استخدام | === استخدام الدالة <code>to()</code> لإنشاء زوج (<code>Pair</code>) === | ||
تُعرّف الشيفرة الآتية متغيرين a و b ثم تستخدم | تُعرّف الشيفرة الآتية متغيرين <code>a</code> و <code>b</code> ثم تستخدم الدالة <code>to()</code> لإنشاء زوج مكون منهما:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val a = 2 | val a = 2 | ||
val b = 6 | val b = 6 | ||
val pair = a.to(b) | val pair = a.to(b) | ||
println(pair) // (2, 6) | |||
} | } | ||
</syntaxhighlight> | |||
=== استخدام | === استخدام الدالة <code>to()</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|inline]]</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") | ||
println(map) // {1=x, 2=y, -1=zz} | println(map) // {1=x, 2=y, -1=zz} | ||
} | } | ||
</syntaxhighlight> | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* صفحة الصنف Pair | * صفحة الصنف [[kotlin/pair|Pair]]: نوع يمثل الأزواج. | ||
== مصادر == | == مصادر == | ||
* صفحة | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/to.html صفحة الدالة to() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 19:10، 9 مايو 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() لإنشاء زوج مكون منهما:
fun main(args: Array<String>) {
val a = 2
val b = 6
val pair = a.to(b)
println(pair) // (2, 6)
}
استخدام الدالة to() في إنشاء قاموس (Map)
تنشئ الشيفرة الآتية قاموسًا باستخدام الدالة to() لإنشاء قاموس (لاحظ أننا لم نستخدم النقطة والأقواس لأنّ الدالة to مُعرّف بنمط التدوين الداخلي inline):
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: نوع يمثل الأزواج.