الدالة windowedSequence()‎ في Kotlin

تعيد الدالة windowedSequence()‎ سلسلة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.  

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

fun CharSequence.windowedSequence(
    size: Int, 
    step: Int = 1, 
    partialWindows: Boolean = false
): Sequence<String>

الإصدار المطلوب: Kotlin 1.2. تعيد الدالة windowedSequence()‎ سلسلة مكونة من سلاسل نصية حجم كل منها يساوي size جلبت من سلسلة المحارف التي استُدعيت معها في كل مرة تقفز فيها الدالة بخطوة ثابتة مقدارها step من المحارف. السلسة النصية الأخيرة المتبقية قد يكون طولها أقل من size، وتضاف إلى القيم المعادة إن كانت قيمة المعامل partialWindows هي true.

fun <R> CharSequence.windowedSequence(
    size: Int, 
    step: Int = 1, 
    partialWindows: Boolean = false, 
    transform: (CharSequence) -> R
): Sequence<R>

الإصدار المطلوب: Kotlin 1.2.

تعيد الدالة windowedSequence()‎ سلسلة تحتوي على نتائج تطبيق الدالة transform على سلاسل نصية حجم كل منها يساوي size جلبت من سلسلة المحارف التي استُدعيت معها في كل مرة تقفز فيها الدالة بخطوة ثابتة مقدارها step من المحارف. السلسة النصية الأخيرة المتبقية قد يكون طولها أقل من size، وتضاف إلى القيم المعادة إن كانت قيمة المعامل partialWindows هي true.

المعاملات

size

عدد صحيح موجب يحدد حجم السلاسل النصية المراد جلبها عند كل خطوة.

step

عدد صحيح موجب يحدد عدد الخطوات التي يراد أن تجلب عند كل منها سلسلة نصية بحجم size. القيمة الافتراضية هي: 1 (أي التحرك بمقدار محرف واحد).

partialWindows

قيمة منطقية تحدد إن كان يراد جلب السلسلة النصية الأخيرة المتبقية أم لا. القيمة الافتراضية هي: false (أي إهمال الجزء الأخير المتبقي).

transform

دالة تطبق على كل سلسلة نصية جلبت عند كل خطوة وتعيد القيمة المقابلة لها.

لاحظ أنّ سلسلة المحارف المُمرّرة إلى الدالة transform سريعة الزوال (ephemeral)، وهي متاحة فقط داخل الدالة. بناءً على ذلك، لا يجب أن تُخزَّن بأي طريقة، إلا إن أعددت مقتطفًا (snapshot) منها.

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

تعاد سلسلة تحتوي على سلاسل نصية حجم كل منها size جلبت من سلسلة المحارف المعطاة عند التحرك بخطوات ثابتة مقدار كل منها step، أو يعاد ناتج تطبيق الدالة transform على سلاسل نصية حجم كل منها size جلبت من سلسلة المحارف المعطاة عند التحرك بخطوات ثابتة مقدار كل منها step.

أمثلة

مثالٌ على استعمال الدالة ()windowedSequence:

fun main(args: Array<String>) {
    println("wiki.hsoub.com".windowedSequence(size = 5, step = 1).toList()) // [wiki., iki.h, ki.hs, i.hso, .hsou, hsoub, soub., oub.c, ub.co, b.com]
    println("wiki.hsoub.com".windowedSequence(size = 5, step = 3).toList()) // [wiki., i.hso, soub., b.com]
}

مثالٌ آخر على استعمال الدالة ()windowedSequence مع تمرير دالة:

fun main(args: Array<String>) {
    println("wiki.hsoub.com".windowedSequence(size = 5, step = 1)  {it.first()}.toList() ) // [w, i, k, i, ., h, s, o, u, b]
    println("wiki.hsoub.com".windowedSequence(size = 5, step = 3) {it.first()}.toList() ) // [w, i, s, b]
}

انظر أيضًا

• الدالة windowed()‎: تعيد قائمة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.  
• الدالة trim()‎: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
• الدالة subSequence()‎ : تعيد جزءًا محددًا من سلسلة المحارف التي استُدعيت معها.
• الدالة slice()‎: تقتطع جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.

مصادر

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