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

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

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

إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى الخريطة.

تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بسلسلة المحارف الأصليَّة.

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

inline fun <K> CharSequence.associateBy(
    keySelector: (Char) -> K
): Map<K, Char>

inline fun <K, V> CharSequence.associateBy(
    keySelector: (Char) -> K, 
    valueTransform: (Char) -> V
): Map<K, V> (source)

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

المعاملات

`keySelector`

دالةٌ يمرر إليها كل محرف من محارف سلسلة المحارف المعطاة على حدة وتعيد المفتاح المقابل لذلك المحرف المراد وضعه في الخريطة.

`valueTransform`

دالةٌ يمرر إليها كل محرف من محارف سلسلة المحارف المعطاة على حدة وتعيد القيمة المقابلة لذلك المحرف المراد وضعها في الخريطة.

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

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

أمثلة

تعرِّف الشيفرة التالية سلسلة نصية باسم str ثمَّ تنشأ خريطة باسم map بتمرير الدالة ()upper (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) إلى ()associateBy ثم تطبع الناتج:

fun main(args: Array<String>) {
    val str = "hsoub"
    val upper: (Char) -> Char = {
        it.toUpperCase()
    }
    val map = str.associateBy(upper)

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

انظر أيضًا

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

الدالة associate()‎: تعيد خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف سلسلة المحارف التي استُدعيت معها إلى الدالة الممررة إليها.

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.associateBy()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.associateBy()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>associateBy()‎</code> <nowiki/>[[Kotlin/Map|قاموسًا]] (map) يحتوي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+<nowiki/>تعيد الدالة <code>associateBy()‎</code> <nowiki/>[[Kotlin/collections/Map|خريطةً]] (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة.
-إن كان لزوجين نفس المفتاح (key)  فالأخير هو الذي سيُضاف إلى [[Kotlin/Map|القاموس]].
+إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى [[Kotlin/collections/Map|الخريطة]].
-يحافظ [[Kotlin/Map|القاموس]]<nowiki/>المُعاد على نفس ترتيب التكرار الخاص  [[Kotlin/CharSequence/index|بسلسلة الحروف]] الأصليَّة.
+تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص  [[Kotlin/CharSequence/index|بسلسلة المحارف]] الأصليَّة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 10: / سطر 10: @@
      keySelector: (Char) -> K
 ): Map<K, Char>
-</syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
+inline fun <K, V> CharSequence.associateBy(
+    keySelector: (Char) -> K,
+    valueTransform: (Char) -> V
+): Map<K, V> (source)
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>keySelector</code> ===
+دالةٌ يمرر إليها كل محرف من محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة على حدة وتعيد المفتاح المقابل لذلك المحرف المراد وضعه في الخريطة.
+=== <code>valueTransform</code> ===
+دالةٌ يمرر إليها كل محرف من محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة على حدة وتعيد القيمة المقابلة لذلك المحرف المراد وضعها في الخريطة.
 ==القيم المعادة==
-[[Kotlin/Map|قاموس]].
+تعاد [[Kotlin/collections/Map|خريطة]] مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code>.
 ==أمثلة==
-===استخدام الدالة <code>()associateBy</code> مع سلسلة نصية ===
+تعرِّف الشيفرة التالية سلسلة نصية باسم <code>str</code> ثمَّ تنشأ [[Kotlin/Map|خريطة]] باسم <code>map</code> بتمرير الدالة <code>()upper</code> (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) إلى <code>()associateBy</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ [[Kotlin/Map|قاموسًا]]<nowiki/>باسم <code>map</code> بتمرير الدالة<code>()upper</code> (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) إلى<code>()associateBy</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "hsoub"
+    val str = "hsoub"
- val upper: (Char) -> Char = {
+    val upper: (Char) -> Char = {
          it.toUpperCase()
      }
@@ سطر 27: / سطر 40: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد  [[Kotlin/MutableMap|قاموسا متغيرا]] (mutable map)  يحتوي أزواجًا من "مفتاح/قيمة"،  إذ القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها،  والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+*الدالة <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تشبه الدالة <code>associateBy()‎</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
-* <code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+*الدالة [[Kotlin/kotlin.text/associate|<code>associate()‎</code>]]: تعيد [[Kotlin/collections/Map|خريطة]] (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها إلى الدالة الممررة إليها.
+*الدالة <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.html الدالة  text.associateBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate-by.html صفحة الدالة CharSequence.associateBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]