Kotlin/to

تنشئ الدالة 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: نوع يمثل الأزواج.

مصادر

• صفحة الدالة to()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.