الدالة text.chunked() في لغة Kotlin
تقطِّع الدالة chunked() سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وإعادتها أو تطبيق دالة معينة على كل منها وإعادة الناتج الذي تعيده.
البنية العامة
fun CharSequence.chunked(size: Int): List<String>
fun <R> CharSequence.chunked(
size: Int,
transform: (CharSequence) -> R
): List<R>
بيئة التشغيل المطلوبة: Kotlin 1.2.
المعاملات
size
عدد صحيح يمثل عدد العناصر المراد اقتطاعها ووضعها في كل سلسلة نصية. يجب أن يكون هذا العدد موجبًا، ويمكن أن يكون أكبر من عدد عناصر سلسلة المحارف المعطاة. يكون غالبًا حجم الجزء الأخير المقتطع أصغر من القيمة size.
transform
دالةٌ يراد تطبيقها على كل جزء مقتطع من سلسلة المحارف المعطاة.
لاحظ أنّ سلسلة المحارف المُمرّرة إلى الدالة transform سريعة الزوال (ephemeral)، وهي متاحة فقط داخل الدالة. بناءً على ذلك، لا يجب أن تُخزَّن بأي طريقة إلا إن أنشأت مقتطفًا (snapshot) منها.
القيم المعادة
تعاد قائمة تحوي جميع الأجزاء المقتطعة من سلسلة المحارف المعطاة التي لا يتجاوز حجمها القيمة size أو تحوي ناتج تطبيق الدالة transform على كل جزء من تلك الأجزاء المقتطعة التي لا يتجاوز حجمها القيمة size.
أمثلة
مثالٌ على استعمال الدالة ()chunked:
fun main(args: Array<String>) {
val words = "one two three four five six seven eight nine ten".split(' ')
val chunks = words.chunked(3)
println(chunks) // [[one, two, three], [four, five, six], [seven, eight, nine], [ten]]
}
انظر أيضًا
associateBy(): تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالةkeySelector.
associateByTo(): تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالةkeySelector.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.