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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function'
مراجعة وتدقيق.
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.associateTo()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.associateTo()‎</code> في Kotlin}}</noinclude>
تملأ الدالة <code>associateTo()‎</code> [[Kotlin/MutableMap|القاموس المتغير]] <code>destination</code>  بأزواج من "مفتاح/قيمة"،  حيث القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها،  والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>.
تشبه الدالة <code>associateTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associate|associate()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 
 
إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة <code>keySelector</code>، فإنَّ الأخير هو الذي سيُضاف إلى القاموس.  
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 9: سطر 7:
     transform: (Char) -> Pair<K, V>
     transform: (Char) -> Pair<K, V>
): M
): M
</syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
 
== المعاملات ==
 
=== <code>destination</code> ===
[[Kotlin/collections/MutableMap|خريطة متغيرة]] تمثل الوجهة التي ستوضع فيها الخرائط التي تعيدها الدالة <code>associateTo()‎</code>.
 
=== <code>transform</code> ===
دالةٌ يمرر إليها كل محرف من محارف سلسلة المحارف المعطاة وتعيد خريطة مكونة من أزواج من "مفتاح/قيمة".
 
==القيم المعادة==
==القيم المعادة==
[[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 والحالة الصغيرة LowerCase) و<nowiki/>[[Kotlin/MutableMap|القاموس المتغير]] <code>map</code> إلى <code>()associateByTo</code>، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val str = "hsoub"
    val str = "hsoub"
val map = mutableMapOf<Char, Char>()
    val map = mutableMapOf<Char, Char>()
      
 
val func: (Char) -> Pair<Char, Char> = {
     val func: (Char) -> Pair<Char, Char> = {
    Pair(it.toUpperCase(), it.toLowerCase())
        Pair(it.toUpperCase(), it.toLowerCase())
}
    }
      
 
str.associateTo(map,func)  
     str.associateTo(map, func)
println(map) // {H=h, S=s, O=o, U=u, B=b}
    println(map) // {H=h, S=s, O=o, U=u, B=b}
}
}
</syntaxhighlight>
</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/associateBy|associateBy()]]‎</code>: تعيد [[Kotlin/collections/Map|خريطةً]] (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة. 
* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</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-to.html الدالة text.associateTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate-to.html صفحة الدالة CharSequence.associateTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 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).

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/associateTo&oldid=16249»