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

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

تنشئ الدالة zip()‎ أزواجًا من محارف سلسلتين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.

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

infix fun CharSequence.zip(
    other: CharSequence
): List<Pair<Char, Char>>

إن استدعيت الدالة zip()‎ مع سلسلة من المحارف ومع تمرير سلسلة أخرى إليها كمعامل، فستشكل أزواجًا من محارف هاتين السلسلتين لها نفس الفهرس وتضعها في قائمة؛ طول القائمة المعادة يساوي طول أٌقصرهما.

inline fun <V> CharSequence.zip(
    other: CharSequence, 
    transform: (a: Char, b: Char) -> V
): List<V>

وإن استدعيت الدالة zip()‎ مع سلسلة من المحارف ومع تمرير سلسلة ودالة إليها، فستعيد قائمة تحوي قيمًا ناتجة عن تمرير محارف هاتين السلسلتين التي لها نفس الفهرس إلى تلك الدالة المعطاة؛ طول القائمة المعادة يساوي طول أٌقصرهما.

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

المعاملات

`other`

سلسلة المحارف الأخرى التي ستطبق عليها العملية.

`transform`

الدالة التي سيمرر إليها المحرفان اللذان يملكان الفهرس نفسه ثم تعيد القيمة المقابلة لهما.

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

تعاد قائمة تحوي أزواجًا منشأة من عناصر الكائنين المعطيين التي لها نفس الفهرس، أو تعاد قائمة من قيمٍ منشأة عبر تمرير عناصر هذين الكائنين التي لها نفس الفهرس إلى دالة معينة

أمثلة

مثالٌ على استعمال الدالة 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()‎ مع تمرير دالة:

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()‎ : تنشئ أزواجًا من محارف السلسلة التي استدعيت معها والمحارف التي لها الفهرس التالي من السلسلة الممررة إليها، أو تنشئ قيمًا ناتجة عن تمرير تلك الأزواج إلى دالة معينة.
الدالة map()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.zip()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>zip()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>zip()</code>‎ [[Kotlin/List|لائحة]] تحتوي كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها.
+تنشئ الدالة <code>zip()‎</code> أزواجًا من محارف سلسلتين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.toList(): List<Char>
+infix fun CharSequence.zip(
+    other: CharSequence
+): List<Pair<Char, Char>>
+</syntaxhighlight>إن استدعيت الدالة <code>zip()‎</code> مع <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] ومع تمرير <nowiki/>[[Kotlin/CharSequence|سلسلة]] أخرى إليها كمعامل، فستشكل أزواجًا من محارف هاتين السلسلتين لها نفس الفهرس وتضعها في قائمة؛ طول القائمة المعادة يساوي طول أٌقصرهما.<syntaxhighlight lang="kotlin">
+inline fun <V> CharSequence.zip(
+    other: CharSequence,
+    transform: (a: Char, b: Char) -> V
+): List<V>
+</syntaxhighlight>وإن استدعيت الدالة <code>zip()‎</code> مع <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] ومع تمرير <nowiki/>[[Kotlin/CharSequence|سلسلة]] ودالة إليها، فستعيد قائمة تحوي قيمًا ناتجة عن تمرير محارف هاتين السلسلتين التي لها نفس الفهرس إلى تلك الدالة المعطاة؛ طول القائمة المعادة يساوي طول أٌقصرهما.
+وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>other</code> ===
+سلسلة المحارف الأخرى التي ستطبق عليها العملية.
+=== <code>transform</code> ===
+الدالة التي سيمرر إليها المحرفان اللذان يملكان الفهرس نفسه ثم تعيد القيمة المقابلة لهما.
-</syntaxhighlight>
 ==القيم المعادة==
-[[Kotlin/List|لائحة]] من الحروف.
+تعاد [[Kotlin/collections/List|قائمة]] تحوي أزواجًا منشأة من عناصر الكائنين المعطيين التي لها نفس الفهرس، أو تعاد قائمة من قيمٍ منشأة عبر تمرير عناصر هذين الكائنين التي لها نفس الفهرس إلى دالة معينة
 ==أمثلة==
-===استخدام الدالة <code>zip()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>zip()‎</code>:<syntaxhighlight lang="kotlin">
-تستدعي الشيفرة الآتية الدالة <code>zip()‎</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
+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)]
+}
+</syntaxhighlight>مثالٌ آخر على استعمال الدالة <code>zip()‎</code> مع تمرير دالة:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     println("Hello, world!".toList()) // [H, e, l, l, o, ,,  , w, o, r, l, d, !]
+     println("hsoub".zip("12345") { x, y -> listOf(x, y) }) // [[h, 1], [s, 2], [o, 3], [u, 4], [b, 5]]
-     println("Hsoub".toList()) // [H, s, o, u, b]
+     println("hsoub".zip("wiki") { x, y -> if (x > y) x else y }) // [w, s, o, u]
-    println("114".toList()) // [1, 1, 4]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/toDouble|toDouble()]]</code>‎ : تحلّل الدالة <code>toDouble()</code>‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Double</code> وتعيد الناتج.
+*الدالة <code>[[Kotlin/kotlin.text/zipWithNext|zipWithNext()]]</code>‎ : تنشئ أزواجًا من محارف [[Kotlin/CharSequence|السلسلة]] التي استدعيت معها والمحارف التي لها الفهرس التالي من [[Kotlin/CharSequence|السلسلة]] الممررة إليها، أو تنشئ قيمًا ناتجة عن تمرير تلك الأزواج إلى دالة معينة.
+* الدالة <code>[[Kotlin/kotlin.text/map|map()‎]]</code>: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
-*<code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
-*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]‎</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
-*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
-*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 ==مصادر==
-<span> </span>
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/zip.html صفحة الدالة zip()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-list.html صفحة الدالة text.zip()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]