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

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

تشبه الدالة associateTo()‎ الدالة associate()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.

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

inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
    destination: M, 
    transform: (Char) -> Pair<K, V>
): M

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

`destination`

خريطة متغيرة تمثل الوجهة التي ستوضع فيها الخرائط التي تعيدها الدالة associateTo()‎.

`transform`

دالةٌ يمرر إليها كل محرف من محارف سلسلة المحارف المعطاة وتعيد خريطة مكونة من أزواج من "مفتاح/قيمة".

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

يعاد المعامل destination نفسه بعد إضافة الخرائط المتشكلة إليه، إذ تنتج هذه الخرائط المضافة عن تمرير محارف سلسلة المحارف المعطاة إلى الدالة transform.

أمثلة

استعمال ()associateByTo لتخزين الخرائط المتشكلة في خريطة موجودةً مسبقًا:

fun main(args: Array<String>) {
    val str = "hsoub"
    val map = mutableMapOf<Char, Char>()

    val func: (Char) -> Pair<Char, Char> = {
        Pair(it.toUpperCase(), it.toLowerCase())
    }

    str.associateTo(map, func)
    println(map) // {H=h, S=s, O=o, U=u, B=b}
}

انظر أيضًا

الدالة associate()‎: تعيد خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف سلسلة المحارف التي استُدعيت معها إلى الدالة الممررة إليها.
الدالة associateBy()‎: تعيد خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة.

الدالة associateByTo()‎: تشبه الدالة associateBy()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
الدالة asIterable()‎: تنشئ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.associateTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.associateTo()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>associateTo()‎</code> [[Kotlin/MutableMap|قاموسا متغيرا]] (mutable map)  يحتوي أزواجًا من "مفتاح/قيمة"،  إذ القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها،  والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+تشبه الدالة <code>associateTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associate|associate()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
-إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة <code>keySelector</code>، فإنَّ الأخير هو الذي سيُضاف إلى القاموس.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <K, M : MutableMap<in K, in Char>> CharSequence.associateByTo(
+inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
      destination: M,
-     keySelector: (Char) -> K
+     transform: (Char) -> Pair<K, V>
 ): M
-</syntaxhighlight>ستعيد الدالة <code>associateByTo()‎</code> [[Kotlin/MutableMap|القاموس المتغير]] <code>destination</code> الذي يحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر  [[Kotlin/CharSequence/index|سلسلة الحروف]]، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>:<syntaxhighlight lang="kotlin">
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
-inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateByTo(
-    destination: M,
+== المعاملات ==
-    keySelector: (Char) -> K,
-    valueTransform: (Char) -> V
+=== <code>destination</code> ===
-): M
+[[Kotlin/collections/MutableMap|خريطة متغيرة]] تمثل الوجهة التي ستوضع فيها الخرائط التي تعيدها الدالة <code>associateTo()‎</code>.
-</syntaxhighlight>إن استدعيت الدالة <code>associateByTo()‎</code> مع [[Kotlin/CharSequence/index|سلسلة حروف]]، فستعيد [[Kotlin/MutableMap|القاموس المتغير]] <code>destination</code> الذي يحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] المعطاة بواسطة <code>valueTransform</code>، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>:
+=== <code>transform</code> ===
+دالةٌ يمرر إليها كل محرف من محارف سلسلة المحارف المعطاة وتعيد خريطة مكونة من أزواج من "مفتاح/قيمة".
-يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
 ==القيم المعادة==
-[[Kotlin/MutableMap|قاموس متغير]].
+يعاد المعامل <code>destination</code> نفسه بعد إضافة الخرائط المتشكلة إليه، إذ تنتج هذه الخرائط المضافة عن تمرير محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة إلى الدالة <code>transform</code>.
 ==أمثلة==
-===استخدام الدالة <code>()associateByTo</code> مع سلسلة نصية===
+استعمال <code>()associateByTo</code> لتخزين الخرائط المتشكلة في خريطة موجودةً مسبقًا:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ  [[Kotlin/MutableMap|قاموسا متغيرا]]  باسم <code>map،</code> ثم تمرّر الدالة <code>()func</code> (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) و<nowiki/>[[Kotlin/MutableMap|القاموس المتغير]] <code>map</code>إلى <code>()associateByTo</code>، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "hsoub"
+    val str = "hsoub"
-val map = mutableMapOf<Char, Char>()
+    val map = mutableMapOf<Char, Char>()
-val func: (Char) -> Char = {it.toUpperCase()}
-str.associateByTo(map,func)
+     val func: (Char) -> Pair<Char, Char> = {
-println(map) // {H=h, S=s, O=o, U=u, B=b}
+        Pair(it.toUpperCase(), it.toLowerCase())
-}
+    }
-</syntaxhighlight>
-===استخدام الدالة <code>()associateTo</code> مع تمرير دالتين===
+     str.associateTo(map, func)
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ  [[Kotlin/MutableMap|قاموسا متغيرا]]  باسم <code>map،</code> ثم تمرّر الدالة <code>()func</code> (التي تحول الحروف إلى الحالة الكبيرة [UpperCase])، والدالة <code>()func2</code> (التي تحول الحروف إلى الحالة الصغيرة [LowerCase])،  إضافة إلى [[Kotlin/MutableMap|القاموس المتغير]] <code>map</code>إلى <code>()associateTo</code>، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+    println(map) // {H=h, S=s, O=o, U=u, B=b}
-fun main(args: Array<String>) {
-val str = "hsoub ACADEMY"
-val map = mutableMapOf<Char, Char>()
-val func: (Char) -> Char = {it.toUpperCase()}
-val func2: (Char) -> Char = {it.toLowerCase()}
-str.associateByTo(map,func, func2)
-println(map) // {H=h, S=s, O=o, U=u, B=b,  = , A=a, C=c, D=d, E=e, M=m, Y=y}
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+*الدالة [[Kotlin/kotlin.text/associate|<code>associate()‎</code>]]: تعيد [[Kotlin/collections/Map|خريطة]] (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها إلى الدالة الممررة إليها.
-* <code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+*الدالة <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد [[Kotlin/collections/Map|خريطةً]] (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+*الدالة <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تشبه الدالة <code>[[Kotlin/kotlin.text/associateBy|associateBy()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
+*الدالة <code>[[Kotlin/kotlin.text/asIterable|asIterable()]]‎</code>: تنشئ نسخةً من الواجهة <code>[[Kotlin/collections/Iterable|Iterable]]</code> التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate-by-to.html الدالة text.associateTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate-to.html صفحة الدالة CharSequence.associateTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]