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