الفرق بين المراجعتين ل"Kotlin/collections/groupBy"
| سطر 75: | سطر 75: | ||
keySelector: (T) -> K | keySelector: (T) -> K | ||
): Map<K, List<T>> | ): Map<K, List<T>> | ||
| − | </syntaxhighlight>في حال استدعاء الدالة<code>groupBy()</code> على [[Kotlin/collections|المجموعات]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر [[Kotlin/ | + | </syntaxhighlight>في حال استدعاء الدالة<code>groupBy()</code> على [[Kotlin/collections|المجموعات]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر [[Kotlin/collections|المجموعة]] الأصلية في [[Kotlin/collections/Map|قاموس]].حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()</code> مُطبّقة على كل عناصر [[Kotlin/collections|المجموعة]] وقيمه [[Kotlin/collections/List|لائحة]] تضم العناصر المقابلة.<syntaxhighlight lang="kotlin"> |
inline fun <T, K, V> Iterable<T>.groupBy( | inline fun <T, K, V> Iterable<T>.groupBy( | ||
keySelector: (T) -> K, | keySelector: (T) -> K, | ||
valueTransform: (T) -> V | valueTransform: (T) -> V | ||
): Map<K, List<V>> | ): Map<K, List<V>> | ||
| − | </syntaxhighlight>في حال استدعاء الدالة<code>groupBy()</code> على [[Kotlin/ | + | </syntaxhighlight>في حال استدعاء الدالة<code>groupBy()</code> على [[Kotlin/collections|المجموعات]] مع تمرير معاملين <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة <code>valueTransform()</code> مُطبّقة على كل عناصر [[Kotlin/Array|المجموعة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()</code> مطبقة على على عناصر [[Kotlin/Array|المجموعة]] وتعيد [[Kotlin/collections/Map|قاموسًا]] حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة. |
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
| سطر 87: | سطر 87: | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير معامل واحد=== | ===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير معامل واحد=== | ||
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست سلاسل نصية باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير الدالة التي تعيد طول السلسلة النصية المُمرّرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]]، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin"> | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير الدالة التي تعيد طول [[Kotlin/collections/String|السلسلة النصية]] المُمرّرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]]، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd") | val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd") | ||
| سطر 95: | سطر 95: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير مُعاملين=== | ===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير مُعاملين=== | ||
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست سلاسل نصية باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير دالة تعيد طول السلسلة النصية المُمرّرة ودالة تعيد المصفوفة بالحروف الكبيرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]] بتحويلها إلى الحروف الكبيرة، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin"> | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير دالة تعيد طول [[Kotlin/collections/String|السلسلة النصية]] المُمرّرة ودالة تعيد المصفوفة بالحروف الكبيرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]] بتحويلها إلى الحروف الكبيرة، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd") | val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd") | ||
مراجعة 18:41، 19 مايو 2018
تعيد الدالةgroupBy() قاموسًا يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).
القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن المصفوفة أو المجموعة الأصلية.
البنية العامة
inline fun <T, K> Array<out T>.groupBy(
keySelector: (T) -> K
): Map<K, List<T>>
inline fun <K> ByteArray.groupBy(
keySelector: (Byte) -> K
): Map<K, List<Byte>>
inline fun <K> ShortArray.groupBy(
keySelector: (Short) -> K
): Map<K, List<Short>>
inline fun <K> IntArray.groupBy(
keySelector: (Int) -> K
): Map<K, List<Int>>
inline fun <K> LongArray.groupBy(
keySelector: (Long) -> K
): Map<K, List<Long>>
inline fun <K> FloatArray.groupBy(
keySelector: (Float) -> K
): Map<K, List<Float>>
inline fun <K> DoubleArray.groupBy(
keySelector: (Double) -> K
): Map<K, List<Double>>
inline fun <K> BooleanArray.groupBy(
keySelector: (Boolean) -> K
): Map<K, List<Boolean>>
inline fun <K> CharArray.groupBy(
keySelector: (Char) -> K
): Map<K, List<Char>>
في حال استدعاء الدالةgroupBy() على المصفوفات مع تمرير معامل واحد keySelector فإنّها تُجمّع عناصر المصفوفة الأصلية في قاموس.حيث مفاتيحه تعيدها الدالة الممرّرة keySelector() مُطبّقة على كل عناصر المصفوفة وقيمه لوائح تضم العناصر المقابلة.
inline fun <T, K, V> Array<out T>.groupBy(
keySelector: (T) -> K,
valueTransform: (T) -> V
): Map<K, List<V>>
inline fun <K, V> ByteArray.groupBy(
keySelector: (Byte) -> K,
valueTransform: (Byte) -> V
): Map<K, List<V>>
inline fun <K, V> ShortArray.groupBy(
keySelector: (Short) -> K,
valueTransform: (Short) -> V
): Map<K, List<V>>
inline fun <K, V> IntArray.groupBy(
keySelector: (Int) -> K,
valueTransform: (Int) -> V
): Map<K, List<V>>
inline fun <K, V> LongArray.groupBy(
keySelector: (Long) -> K,
valueTransform: (Long) -> V
): Map<K, List<V>>
inline fun <K, V> FloatArray.groupBy(
keySelector: (Float) -> K,
valueTransform: (Float) -> V
): Map<K, List<V>>
inline fun <K, V> DoubleArray.groupBy(
keySelector: (Double) -> K,
valueTransform: (Double) -> V
): Map<K, List<V>>
inline fun <K, V> BooleanArray.groupBy(
keySelector: (Boolean) -> K,
valueTransform: (Boolean) -> V
): Map<K, List<V>>
inline fun <K, V> CharArray.groupBy(
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): Map<K, List<V>>
في حال استدعاء الدالةgroupBy() على المصفوفات مع تمرير معاملين valueTransform و keySelector فإنّها تُجمّع العناصر المعادة من قبل الدالة valueTransform() مُطبّقة على كل عناصر المصفوفة وتربطها بالمفتاح الذي تعيده الدالةkeySelector() مطبقة على على عناصر المصفوفة وتعيد قاموسًا حيث كل مفتاح مرتبط بلائحة العناصر المقابلة.
inline fun <T, K> Iterable<T>.groupBy(
keySelector: (T) -> K
): Map<K, List<T>>
في حال استدعاء الدالةgroupBy() على المجموعات مع تمرير معامل واحد keySelector فإنّها تُجمّع عناصر المجموعة الأصلية في قاموس.حيث مفاتيحه تعيدها الدالة الممرّرة keySelector() مُطبّقة على كل عناصر المجموعة وقيمه لائحة تضم العناصر المقابلة.
inline fun <T, K, V> Iterable<T>.groupBy(
keySelector: (T) -> K,
valueTransform: (T) -> V
): Map<K, List<V>>
في حال استدعاء الدالةgroupBy() على المجموعات مع تمرير معاملين valueTransform و keySelector فإنّها تُجمّع العناصر المعادة من قبل الدالة valueTransform() مُطبّقة على كل عناصر المجموعة وتربطها بالمفتاح الذي تعيده الدالةkeySelector() مطبقة على على عناصر المجموعة وتعيد قاموسًا حيث كل مفتاح مرتبط بلائحة العناصر المقابلة.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
قاموس يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).
أمثلة
استخدام الدالة ()groupBy مع المصفوفات مع تمرير معامل واحد
تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ست سلاسل نصية باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()groupBy على array بتمرير الدالة التي تعيد طول السلسلة النصية المُمرّرة، وتجمّع عناصر array التي لها نفس الطول في قاموس، ثم تطبع القاموس:
fun main(args: Array<String>) {
val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
print(array.groupBy { it.length } ) // {1=[a], 3=[abc, def], 2=[ab], 4=[avde, abcd]}
}
استخدام الدالة ()groupBy مع المصفوفات مع تمرير مُعاملين
تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ست سلاسل نصية باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()groupBy على array بتمرير دالة تعيد طول السلسلة النصية المُمرّرة ودالة تعيد المصفوفة بالحروف الكبيرة، وتجمّع عناصر array التي لها نفس الطول في قاموس بتحويلها إلى الحروف الكبيرة، ثم تطبع القاموس:
fun main(args: Array<String>) {
val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
print(array.groupBy( { it.length }, {it.toUpperCase()} )) // {1=[A], 3=[ABC, DEF], 2=[AB],
// 4=[AVDE, ABCD]}
}
انظر أيضًا
groupByTo(): تضيف إلى القاموس المُمرّر عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).