Kotlin/kotlin.text/zipWithNext

يختلف سلوك الدالة zipWithNext()‎ بحسب نوع وعدد الوسائط المُمرّرة (انظر فقرة البنية العامة).

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

fun CharSequence.zipWithNext(): List<Pair<Char, Char>>

بيئة التشغيل المطلوبة: Kotlin 1.2 تعيد الدالة zipWithNext()‎ لائحة تحتوي أزواجًا (pairs) مُركّبة من حروف سلسلة الحروف  التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة other التي عند الفهرس الموالي، اللائحة المُعادة ستكون فارغة إن كانت سلسلة حروف الأصلية تحتوي أقل من حرفين.

inline fun <R> CharSequence.zipWithNext(
    transform: (a: Char, b: Char) -> R
): List<R>

بيئة التشغيل المطلوبة: Kotlin 1.2

تعيد الدالة zipWithNext()‎ لائحة تحتوي نتائج تطبيق الدالة المُمرّرة transform على حروف سلسلة الحروف  التي استٌدعيت عبرها وعلى حروف السلسلة الأخرى المًمرّرة other التي عند الفهرس الموالي، اللائحة المُعادة ستكون فارغة إن كانت سلسلة حروف الأصلية تحتوي أقل من حرفين.

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

لائحة.

أمثلة

استخدام الدالة zipWithNext()‎ مع السلاسل النصية

تعرّف الشيفرة الآتية لائحة حروف باسم letters، ثم تستدعي الدالة zipWithNext()‎ عبرها وتحيل الناتج إلى المتغير pairs، وتطبع الناتج:

fun main(args: Array<String>) {
val letters = ('a'..'f').toList()
val pairs = letters.zipWithNext()

println(letters) // [a, b, c, d, e, f]
println(pairs) // [(a, b), (b, c), (c, d), (d, e), (e, f)]
}

استخدام الدالة zipWithNext()‎ مع السلاسل النصية مع تمرير دالة

تعرّف الشيفرة الآتية لائحة أعداد باسم values، ثم تستدعي الدالة zipWithNext()‎ عبرها مع تمرير دالة كوسيط وتحيل الناتج إلى المتغير deltas، وتطبع الناتج:

fun main(args: Array<String>) {
val values = listOf(1, 4, 9, 16, 25, 36)
val deltas = values.zipWithNext { a, b -> b - a }

println(deltas) // [3, 5, 7, 9, 11]
}

انظر أيضًا

• zip()‎ : تعيد الدالة zip()‎ لائحة تحتوي أزواجًا (pairs) مُركّبة من حروف سلسلة الحروف  التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة other التي لها نفس الفهرس، اللائحة المُعادة لها طول أقصر سلسلة حروف.

• toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
• toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

• isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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