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

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

تقطِّع الدالة 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]]
}

انظر أيضًا

الدالة chunkedSequence()‎: تقطِّع سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في سلسلة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في سلسلة.
الدالة compareTo()‎: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
الدالة count()‎: تَعُدُّ جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.chunked()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.chunked()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>chunked()‎</code> مجموعة المحارف المُسمّاة (named charset) ذات الاسم المُمرّر <code>charsetName.</code>
+تقطِّع الدالة <code>chunked()‎</code> [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في [[Kotlin/collections/List|قائمة]] أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في [[Kotlin/collections/List|قائمة]].
-في حال كانت مجموعة المحارف المُسمّاة غير متاحة فسيطلق Kotlin  استثناءً <code>UnsupportedCharsetException</code> .
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun charset(charsetName: String): Charset
+fun CharSequence.chunked(size: Int): List<String>
+fun <R> CharSequence.chunked(
+    size: Int,
+    transform: (CharSequence) -> R
+): List<R>
+</syntaxhighlight>'''بيئة التشغيل المطلوبة:''' Kotlin 1.2.
+== المعاملات ==
+=== <code>size</code> ===
+عدد صحيح يمثل عدد العناصر المراد اقتطاعها ووضعها في كل سلسلة نصية. يجب أن يكون هذا العدد موجبًا، ويمكن أن يكون أكبر من عدد عناصر سلسلة المحارف المعطاة. يكون غالبًا حجم الجزء الأخير المقتطع أصغر من القيمة <code>size</code>.
+=== <code>transform</code> ===
+دالةٌ يراد تطبيقها على كل جزء مقتطع من سلسلة المحارف المعطاة.
+لاحظ أنّ [[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إلى الدالة <code>transform</code> سريعة الزوال (ephemeral)، وهي متاحة فقط داخل الدالة. بناءً على ذلك، لا يجب أن تُخزَّن بأي طريقة إلا إن أنشأت مقتطفًا (snapshot) منها.
-</syntaxhighlight>
 ==القيم المعادة==
-مجموعة محارف (<code>charset</code>).
+تعاد [[Kotlin/collections/List|قائمة]] تحوي جميع الأجزاء المقتطعة من سلسلة المحارف المعطاة التي لا يتجاوز حجمها القيمة <code>size</code> أو تحوي ناتج تطبيق الدالة <code>transform</code> على كل جزء من تلك الأجزاء المقتطعة التي لا يتجاوز حجمها القيمة <code>size</code>.
 ==أمثلة==
-===استخدام الدالة <code>()chunked</code>===
+مثالٌ على استعمال الدالة <code>()chunked</code>:<syntaxhighlight lang="kotlin">
-تستدعي الشيفرة الآتية الدالة  <code>()chunked</code> مع تمرير  <code>"Windows-1251"</code> كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     println(charset("Windows-1251")) // windows-1251
+     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]]
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+*الدالة <code>[[Kotlin/kotlin.text/chunkedSequence|chunkedSequence()‎]]</code>: تقطِّع [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في [[Kotlin/sequences/Sequence|سلسلة]] أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في [[Kotlin/sequences/Sequence|سلسلة]].
+*الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: توازن بين [[Kotlin/String|سلسلتين نصيتين]] معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
-* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+*الدالة <code>[[Kotlin/kotlin.text/count|count()‎]]</code>: تَعُدُّ جميع محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها، أو المحارف المحققة لشرط معين.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/charset.html الدالة text.chunked()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/chunked.html صفحة الدالة CharSequence.chunked()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]