الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/zip»
< Kotlin | kotlin.text
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع text.zip() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع text.zip() في لغة Kotlin}}</noinclude> | ||
يختلف سلوك الدالة <code>zip()</code> بحسب نوع وعدد الوسائط المُمرّرة (انظر فقرة [[Kotlin/kotlin.text/zip#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 12: | سطر 12: | ||
): List<V> | ): List<V> | ||
</syntaxhighlight>تعيد الدالة <code>zip()</code> [[Kotlin/List|لائحة]] تحتوي نتائج تطبيق الدالة المُمرّرة <code>transform</code> على حروف [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى حروف السلسلة الأخرى المًمرّرة <code>other</code> التي لها نفس الفهرس، [[Kotlin/List|اللائحة]] المُعادة لها طول أقصر [[Kotlin/CharSequence/index|سلسلة حروف]]. | </syntaxhighlight>تعيد الدالة <code>zip()</code> [[Kotlin/List|لائحة]] تحتوي نتائج تطبيق الدالة المُمرّرة <code>transform</code> على حروف [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى حروف السلسلة الأخرى المًمرّرة <code>other</code> التي لها نفس الفهرس، [[Kotlin/List|اللائحة]] المُعادة لها طول أقصر [[Kotlin/CharSequence/index|سلسلة حروف]]. | ||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 24: | سطر 26: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== | ===استخدام الدالة <code>zip()</code> مع السلاسل النصية مع تمرير دالة=== | ||
تستدعي الشيفرة الآتية الدالة <code>zip()</code> عبر عدة [[Kotlin/String|سلاسل نصية]] مع تمرير [[Kotlin/String|سلسلة نصية]] ودالة كوسيط، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | تستدعي الشيفرة الآتية الدالة <code>zip()</code> عبر عدة [[Kotlin/String|سلاسل نصية]] مع تمرير [[Kotlin/String|سلسلة نصية]] ودالة كوسيط، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| سطر 32: | سطر 34: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* <code>[[Kotlin/kotlin.text/ | * <code>[[Kotlin/kotlin.text/zipWithNext|zipWithNext()]]</code> : تتعيد الدالة <code>zipWithNext()</code> [[Kotlin/List|لائحة]] تحتوي [[Kotlin/Pair/index|أزواجًا]] (pairs) مُركّبة من حروف [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة <code>other</code> التي عند الفهرس الموالي، [[Kotlin/List|اللائحة]] المُعادة ستكون فارغة إن كانت [[Kotlin/CharSequence/index|سلسلة حروف]] الأصلية تحتوي أقل من حرفين. | ||
*<code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | *<code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | ||
| سطر 39: | سطر 41: | ||
*<code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode). | *<code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode). | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/zip.html صفحة الدالة text.zip() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/zip.html صفحة الدالة text.zip() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 07:34، 14 يوليو 2018
يختلف سلوك الدالة zip() بحسب نوع وعدد الوسائط المُمرّرة (انظر فقرة البنية العامة).
البنية العامة
infix fun CharSequence.zip(
other: CharSequence
): List<Pair<Char, Char>>
تعيد الدالة zip() لائحة تحتوي أزواجًا (pairs) مُركّبة من حروف سلسلة الحروف التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة other التي لها نفس الفهرس، اللائحة المُعادة لها طول أقصر سلسلة حروف.
inline fun <V> CharSequence.zip(
other: CharSequence,
transform: (a: Char, b: Char) -> V
): List<V>
تعيد الدالة zip() لائحة تحتوي نتائج تطبيق الدالة المُمرّرة transform على حروف سلسلة الحروف التي استٌدعيت عبرها وعلى حروف السلسلة الأخرى المًمرّرة other التي لها نفس الفهرس، اللائحة المُعادة لها طول أقصر سلسلة حروف.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
أمثلة
استخدام الدالة zip() مع السلاسل النصية
تستدعي الشيفرة الآتية الدالة zip() عبر عدة سلاسل نصية مع تمرير سلسلة نصية كوسيط، وتطبع الناتج:
fun main(args: Array<String>) {
println("hsoub".zip("12345")) // [(h, 1), (s, 2), (o, 3), (u, 4), (b, 5)]
println("hsoub".zip("12")) // [(h, 1), (s, 2)]
println("hsoub" zip "HSOUB") // [(h, H), (s, S), (o, O), (u, U), (b, B)]
}
استخدام الدالة zip() مع السلاسل النصية مع تمرير دالة
تستدعي الشيفرة الآتية الدالة zip() عبر عدة سلاسل نصية مع تمرير سلسلة نصية ودالة كوسيط، وتطبع الناتج:
fun main(args: Array<String>) {
println("hsoub".zip("12345") {x, y -> listOf(x,y) }) // [[h, 1], [s, 2], [o, 3], [u, 4], [b, 5]]
println("hsoub".zip("wiki") {x, y -> if (x > y) x else y }) // [w, s, o, u]
}
انظر أيضًا
zipWithNext() : تتعيد الدالةzipWithNext() لائحة تحتوي أزواجًا (pairs) مُركّبة من حروف سلسلة الحروف التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرةotherالتي عند الفهرس الموالي، اللائحة المُعادة ستكون فارغة إن كانت سلسلة حروف الأصلية تحتوي أقل من حرفين.
toUpperCase() : تحوّل الدالةtoUpperCase() الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).toBigDecimal(): تحلّل الدالةtoBigDecimal() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.
isDefined(): تعيد القيمةtrueفي حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).