الفرق بين المراجعتين ل"Kotlin/kotlin.text/windowedSequence"

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

تعيد الدالة 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.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.windowedSequence()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>windowedSequence()‎</code> في Kotlin}}</noinclude>
-تعيد  الدالة <code>windowedSequence()‎</code> سلسلة (Sequence) مكونة  من [[Kotlin/String|سلاسل نصية]] مُقتطفة من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها (انظر فقرة [[Kotlin/kotlin.text/windowedSequence#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+تعيد الدالة <code>windowedSequence()‎</code> [[Kotlin/sequences/Sequence|سلسلة]] تحتوي على [[Kotlin/String|سلاسل نصية]] بحجم معين ثابت جلبت من [[Kotlin/CharSequence|سلسلة المحارف]] التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 8: / سطر 8: @@
      partialWindows: Boolean = false
 ): Sequence<String>
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.2'''
+</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.2.
-تعيد  الدالة <code>windowedSequence()‎</code> سلسلة مكونة  من [[Kotlin/String|سلاسل نصية]] بطول يساوي <code>size</code> مُقتطفة من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، والتي تقتطفها بالتدرج بحيث تقفز في كل مرة <code>step</code> حرفا.  [[Kotlin/String|السلاسل النصية]] الأخيرة قد يكون طولها أقل من <code>size</code>.
+تعيد الدالة <code>windowedSequence()‎</code> [[Kotlin/collections/List|سلسلة]] مكونة من [[Kotlin/String|سلاسل نصية]] حجم كل منها يساوي <code>size</code> جلبت من [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها في كل مرة تقفز فيها الدالة بخطوة ثابتة مقدارها <code>step</code> من المحارف. [[Kotlin/String|السلسة النصية]] الأخيرة المتبقية قد يكون طولها أقل من <code>size</code>، وتضاف إلى القيم المعادة إن كانت قيمة المعامل <code>partialWindows</code> هي <code>true</code>.<syntaxhighlight lang="kotlin">
-كلا الوسيطين <code>step</code>  و <code>size</code> ينبغي أن يكونا موجبين، ويمكن أن يكونا أكبر من طول [[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية.
-الوسيط <code>windowedSequence</code> يحدد ما إذا كانت الدالة ستعيد  [[Kotlin/String|السلاسل النصية]] الجزئية في الأخير، وقيمتها الإفتراضية هي <code>false</code>.  <syntaxhighlight lang="kotlin">
 fun <R> CharSequence.windowedSequence(
      size: Int,
@@ سطر 21: / سطر 17: @@
      transform: (CharSequence) -> R
 ): Sequence<R>
-</syntaxhighlight>تعيد  الدالة <code>windowedSequence()‎</code> سلسلة مكونة  من نتائج تطبيق الدالة <code>transform</code> على [[Kotlin/String|السلاسل النصية]] المُقتطفة من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي طولها يساوي <code>size</code> وتقتطفها بالتدرج بحيث تقفز في كل مرة <code>step</code> حرفا.  [[Kotlin/String|السلاسل النصية]] الأخيرة قد يكون طولها أقل من <code>size</code>.
+</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.2.
+تعيد الدالة <code>windowedSequence()‎</code> [[Kotlin/collections/List|سلسلة]] تحتوي على نتائج تطبيق الدالة <code>transform</code> على [[Kotlin/String|سلاسل نصية]] حجم كل منها يساوي <code>size</code> جلبت من [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها في كل مرة تقفز فيها الدالة بخطوة ثابتة مقدارها <code>step</code> من المحارف. [[Kotlin/String|السلسة النصية]] الأخيرة المتبقية قد يكون طولها أقل من <code>size</code>، وتضاف إلى القيم المعادة إن كانت قيمة المعامل <code>partialWindows</code> هي <code>true</code>.
+== المعاملات ==
+=== <code>size</code> ===
+[[Kotlin/Int|عدد صحيح]] موجب يحدد حجم السلاسل النصية المراد جلبها عند كل خطوة.
+=== <code>step</code> ===
+[[Kotlin/Int|عدد صحيح]] موجب يحدد عدد الخطوات التي يراد أن تجلب عند كل منها سلسلة نصية بحجم <code>size</code>. القيمة الافتراضية هي: 1 (أي التحرك بمقدار محرف واحد).
-لاحظ أنّ سلسلة الحروف المُمرّرة إلى الدالة <code>transform</code> سريعة الزوال (ephemeral)، وهي متاحة فقط داخل الدالة. لذلك لا يجب عليك أن تُخزّنها بأي طريقة، إلا إن أعددت مقتطفًا (snapshot) منها.
+=== <code>partialWindows</code> ===
+قيمة منطقية تحدد إن كان يراد جلب السلسلة النصية الأخيرة المتبقية أم لا. القيمة الافتراضية هي: <code>false</code> (أي إهمال الجزء الأخير المتبقي).
-كلا الوسيطين <code>step</code>  و <code>size</code> ينبغي أن يكونا موجبين، ويمكن أن يكونا أكبر من طول [[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية.
+=== <code>transform</code> ===
+دالة تطبق على كل سلسلة نصية جلبت عند كل خطوة وتعيد القيمة المقابلة لها.
-الوسيط <code>partialWindows</code> يحدد ما إذا كانت الدالة ستعيد  [[Kotlin/String|السلاسل النصية]] الجزئية في الأخير، وقيمتها الإفتراضية هي <code>false</code>.
+لاحظ أنّ سلسلة المحارف المُمرّرة إلى الدالة <code>transform</code> سريعة الزوال (ephemeral)، وهي متاحة فقط داخل الدالة. بناءً على ذلك، لا يجب أن تُخزَّن بأي طريقة، إلا إن أعددت مقتطفًا (snapshot) منها.
 ==القيم المعادة==
-سلسلة مكونة  من [[Kotlin/String|سلاسل نصية]].
+تعاد [[Kotlin/sequences/Sequence|سلسلة]] تحتوي على [[Kotlin/String|سلاسل نصية]] حجم كل منها <code>size</code> جلبت من سلسلة المحارف المعطاة عند التحرك بخطوات ثابتة مقدار كل منها <code>step</code>، أو يعاد ناتج تطبيق الدالة <code>transform</code> على [[Kotlin/String|سلاسل نصية]] حجم كل منها <code>size</code> جلبت من سلسلة المحارف المعطاة عند التحرك بخطوات ثابتة مقدار كل منها <code>step</code>.
 ==أمثلة==
-===استخدام الدالة <code>()windowedSequence</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()windowedSequence</code>:<syntaxhighlight lang="kotlin">
-تستدعي الشيفرة الآتية الدالة  <code>()windowedSequence</code> عبر عدة [[Kotlin/String|سلاسل نصية]] وتمرر إليها عددين كوسيطين، و<nowiki/>تطبع الناتج:<syntaxhighlight lang="kotlin">
 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 = 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]
+    println("wiki.hsoub.com".windowedSequence(size = 5, step = 3).toList()) // [wiki., i.hso, soub., b.com]
 }
-</syntaxhighlight>
+</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>()windowedSequence</code> مع تمرير دالة:<syntaxhighlight lang="kotlin">
-===استخدام الدالة <code>()windowedSequence</code> مع سلسلة نصية مع تمرير دالة===
-تستدعي الشيفرة الآتية الدالة <code>()windowedSequence</code> عبر عدة [[Kotlin/String|سلاسل نصية]] وتمرر إليها عددين ودالة كوسائط، وتطبع الناتج<syntaxhighlight lang="kotlin">
 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 = 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]
+    println("wiki.hsoub.com".windowedSequence(size = 5, step = 3) {it.first()}.toList() ) // [w, i, s, b]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/trim|trim()]]‎</code>: تعيد  الدالة <code>trim()‎</code> جزءًا من [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها بعد حذف الأحرف الأولى والأخيرالتي تحقق الشرط المنطقي المُحدّد <code>predicate.</code>
+*الدالة <code>[[Kotlin/kotlin.text/windowed|windowed()‎]]</code>: تعيد [[Kotlin/collections/List|قائمة]] تحتوي على [[Kotlin/String|سلاسل نصية]] بحجم معين ثابت جلبت من [[Kotlin/CharSequence|سلسلة المحارف]] التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.
+*الدالة <code>[[Kotlin/kotlin.text/trim|trim()]]‎</code>: تحذف المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/substringAfter|substringAfter()]]‎</code>: تعيد  الدالة <code>substringAfter()‎</code> جزءًا من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُتواجد بعد أول ظهور للمُحدِّد <code>delimiter،</code> إن لم تكن [[Kotlin/String|السلسلة النصية]] الأصلية تحتوي <code>delimiter</code>، فستعيد القيمة المُمرّرة <code>missingDelimiterValue</code>، والتي قيمتها الافتراضية هي [[Kotlin/String|السلسلة النصية]] الأصلية.
+* الدالة <code>[[Kotlin/kotlin.text/subSequence|subSequence()‎]]</code> : تعيد جزءًا محددًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/substringBefore|substringBefore()]]‎</code>: تعيد  الدالة <code>substringBefore()‎</code> جزءًا من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُتواجد قبل أول ظهور للمُحدِّد <code>delimiter،</code> إن لم تكن [[Kotlin/String|السلسلة النصية]] الأصلية تحتوي <code>delimiter</code>، فستعيد القيمة المُمرّرة <code>missingDelimiterValue</code>، والتي قيمتها الافتراضية هي [[Kotlin/String|السلسلة النصية]] الأصلية.
+*الدالة <code>[[Kotlin/kotlin.text/slice|slice()]]‎</code>: تقتطع جزءًا محدَّدًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.
-* <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]‎</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.
-* <code>[[Kotlin/kotlin.text/slice|slice()]]‎</code>: تعيد  الدالة <code>slice()‎</code> [[Kotlin/CharSequence/index|سلسلة حروف]] أو [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/windowed-sequence.html الدالة text.windowedSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/windowed-sequence.html صفحة الدالة windowedSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]