الفرق بين المراجعتين لصفحة: «Kotlin/to»

المراجعة الحالية بتاريخ 06:20، 8 سبتمبر 2018

تنشئ الدالة to()‎ عنصرًا من النوع Pair مكونًا من الكائن الذي استُدعي معه والمعامل الذي مُرّر إليه، أي العنصر that.

البنية العامة

infix fun <A, B> A.to(that: B): Pair<A, B>

يُلاحَظ وجود الكلمة المفتاحية infix للدلالة على أن هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً، وللمزيد من التفاصيل راجع توثيق التدوين الداخلي للدوال (infix functions).

المعاملات

`that`

الكائن المراد استعماله مع الكائن المعطى في إنشاء كائن من النوع Pair.

القيم المعادة

يعاد عنصرٌ من النوع Pair مكونًا من الكائن استُدعي عبره والوسيط (argument) الذي مُرّر إليه.

أمثلة

استخدام الدالة to()‎ لإنشاء عنصر من النوع Pair:

fun main(args: Array<String>) {
   val a = 2
   val b = 6
   val pair = a.to(b)
 
   println(pair)   // (2, 6)
}

استخدام الدالة to()‎ في إنشاء عنصر من النوع Map:

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 المُستخدَم للتعامل مع الأزواج.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة to()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎to()‎</code> في Kotlin}}</noinclude>
-تنشئ الدالة <code>to()</code>‎ عنصرًا من النوع <code>Pair</code> مكونًا من الكائن الذي استُدعي عبره والوسيط (argument) الذي مُرّر إليه، أي العنصر <code>that</code>.
+تنشئ الدالة <code>to()</code>‎ عنصرًا من النوع <code>[[Kotlin/Pair|Pair]]</code> مكونًا من الكائن الذي استُدعي معه والمعامل الذي مُرّر إليه، أي العنصر <code>that</code>.
 == البنية العامة ==
@@ سطر 6: / سطر 6: @@
 infix fun <A, B> A.to(that: B): Pair<A, B>
 </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>that</code> ===
+الكائن المراد استعماله مع الكائن المعطى في إنشاء كائن من النوع <code>[[Kotlin/Pair|Pair]]</code>.
 == القيم المعادة ==
-يعيد عنصرًا من النوع <code>Pair</code> مكونًا من الكائن استُدعي عبره والوسيط (argument) الذي مُرّر إليه.
+يعاد عنصرٌ من النوع <code>[[Kotlin/Pair|Pair]]</code> مكونًا من الكائن استُدعي عبره والوسيط (argument) الذي مُرّر إليه.
 == أمثلة ==
+استخدام الدالة <code>to()‎</code> لإنشاء عنصر من النوع <code>Pair</code>:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>to()‎</code> لإنشاء عنصر من النوع <code>Pair</code> ===
-تُعرّف الشيفرة الآتية متغيرين صحيحين <code>a</code> و <code>b</code> ثم تستخدم الدالة <code>to()‎</code> لإنشاء زوجٍ (<code>pair</code>) مكوَّنٍ منهما:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
    val a = 2
@@ سطر 19: / سطر 22: @@
    val pair = a.to(b)
-  println(pair)   // (2, 6)
+   println(pair)   // (2, 6)
 }
-</syntaxhighlight>
+</syntaxhighlight>استخدام الدالة <code>to()</code>‎ في إنشاء عنصر من النوع <code>Map</code>:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <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>) {
-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>
 == انظر أيضًا ==
-* الصنف [[kotlin/pair|Pair]]: يعبِّر عن النوع pair المُستخدَم للتعامل مع الأزواج.
+* الصنف [[Kotlin/pair|Pair]]: يعبِّر عن النوع pair المُستخدَم للتعامل مع الأزواج.
 == مصادر ==