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

مراجعة 18:43، 7 يوليو 2018

تملأ الدالة associateTo()‎ القاموس المتغير destination بأزواج من "مفتاح/قيمة"، حيث القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة transform.

إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة keySelector، فإنَّ الأخير هو الذي سيُضاف إلى القاموس.

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

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

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

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

قاموس متغير.

أمثلة

استخدام الدالة `()associateByTo` مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تنشئ قاموسا متغيرا باسم map، ثم تمرّر الدالة ()func (التي تحول الحرف إلى زوج مكون من الحرف في الحالة الكبيرة UpperCase والحالة الصغيرة LowerCase) والقاموس المتغير map إلى ()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}
}

انظر أيضًا

associateBy()‎: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة keySelector.

associateByTo()‎: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.associateTo()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>associateTo()‎</code> [[Kotlin/MutableMap|قاموسا متغيرا]] (mutable map)  يحتوي أزواجًا من "مفتاح/قيمة"،  إذ القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها،  والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+تملأ الدالة <code>associateTo()‎</code> [[Kotlin/MutableMap|القاموس المتغير]] <code>destination</code>  بأزواج من "مفتاح/قيمة"،  حيث القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها،  والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</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
-): M
-</syntaxhighlight>إن استدعيت الدالة <code>associateByTo()‎</code> مع [[Kotlin/CharSequence/index|سلسلة حروف]]، فستعيد [[Kotlin/MutableMap|القاموس المتغير]] <code>destination</code> الذي يحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] المعطاة بواسطة <code>valueTransform</code>، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>:
-يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
 ==القيم المعادة==
 [[Kotlin/MutableMap|قاموس متغير]].
 ==أمثلة==
 ===استخدام الدالة <code>()associateByTo</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ  [[Kotlin/MutableMap|قاموسا متغيرا]]  باسم <code>map،</code> ثم تمرّر الدالة <code>()func</code> (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) و<nowiki/>[[Kotlin/MutableMap|القاموس المتغير]] <code>map</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>) {
 val str = "hsoub"
 val map = mutableMapOf<Char, Char>()
-val func: (Char) -> Char = {it.toUpperCase()}
+val func: (Char) -> Pair<Char, Char> = {
-str.associateByTo(map,func)
+    Pair(it.toUpperCase(), it.toLowerCase())
-println(map) // {H=h, S=s, O=o, U=u, B=b}
 }
-</syntaxhighlight>
-===استخدام الدالة <code>()associateTo</code> مع تمرير دالتين===
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <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">
-fun main(args: Array<String>) {
-val str = "hsoub ACADEMY"
-val map = mutableMapOf<Char, Char>()
-val func: (Char) -> Char = {it.toUpperCase()}
+str.associateTo(map,func)
-val func2: (Char) -> Char = {it.toLowerCase()}
+println(map) // {H=h, S=s, O=o, U=u, B=b}
-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>.
-* <code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
 * <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</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 الدالة text.associateTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]