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