الفرق بين المراجعتين ل"Kotlin/collections/drop"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>drop()‎</code> لائحة ت...')
 
ط
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>drop()‎</code> [[Kotlin/List|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها والتي تختلف نتائج تطبيق الدالة (<code>selector</code>) عليها، ومع احترام ظهور تلك العناصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/Array|المجموعة]].
+
تعيد الدالة <code>drop()‎</code> [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
  
 
== البنية العامة ==
 
== البنية العامة ==
استدعاء الدالة <code>distinctBy()‎</code> عبر  [[Kotlin/Array|مصفوفة]].<syntaxhighlight lang="kotlin">
+
<syntaxhighlight lang="kotlin">
inline fun <T, K> Array<out T>.distinctBy(
+
fun <T> Array<out T>.drop(n: Int): List<T>  
    selector: (T) -> K
+
fun ByteArray.drop(n: Int): List<Byte>  
): List<T>  
+
fun ShortArray.drop(n: Int): List<Short>  
inline fun <K> ByteArray.distinctBy(
+
fun IntArray.drop(n: Int): List<Int>  
    selector: (Byte) -> K
+
fun LongArray.drop(n: Int): List<Long>  
): List<Byte>  
+
fun FloatArray.drop(n: Int): List<Float>
inline fun <K> ShortArray.distinctBy(
+
fun DoubleArray.drop(n: Int): List<Double>  
    selector: (Short) -> K
+
fun BooleanArray.drop(n: Int): List<Boolean>  
): List<Short>  
+
fun CharArray.drop(n: Int): List<Char>  
inline fun <K> IntArray.distinctBy(
+
fun <T> Iterable<T>.drop(n: Int): List<T>  
    selector: (Int) -> K
 
): List<Int>  
 
inline fun <K> LongArray.distinctBy(
 
    selector: (Long) -> K
 
): List<Long>  
 
inline fun <K> FloatArray.distinctBy(
 
    selector: (Float) -> K
 
): List<Float>  
 
inline fun <K> DoubleArray.distinctBy(
 
    selector: (Double) -> K
 
): List<Double>
 
inline fun <K> BooleanArray.distinctBy(
 
    selector: (Boolean) -> K
 
): List<Boolean>
 
inline fun <K> CharArray.distinctBy(
 
    selector: (Char) -> K
 
): List<Char>  
 
  
 
</syntaxhighlight>
 
</syntaxhighlight>
  
في حال استدعاء الدالة <code>distinctBy()‎</code> عبر  [[Kotlin/collections|مجموعة]].<syntaxhighlight lang="kotlin">
+
== المعاملات ==
inline fun <T, K> Iterable<T>.distinctBy(
+
 
    selector: (T) -> K
+
=== <code>n</code> ===
): List<T>
+
عدد صحيح يمثل عدد العناصر المراد حذفها من بداية [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة.
</syntaxhighlight>
 
  
 
== القيم المعادة ==
 
== القيم المعادة ==
  
[[Kotlin/List|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها والتي تختلف نتائج تطبيق دالة (<code>selector</code>) عليها.
+
تُعاد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة باستثناء العناصر <code>n</code> الأولى.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()drop</code> مع المصفوفات: الحالة الأولى ===
+
===استخدام الدالة <code>()drop</code> مع المصفوفات  ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من تسعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم <code>()selector</code>، ثم تستخدم الدالة <code>()drop</code> للحصول على لائحة تضم العناصر التي تختلف نتائج تطبيق الدالة <code>()selector</code>عليها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()drop</code> لحذف أول عنصرين من عناصر هذه المصفوفة:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
 
val array = arrayOf(1,2,3,4,4,5,2,6,22)
 
val selector: (Int) -> Int = {it+ 10}
 
println(array.distinctBy(selector)) // [1, 2, 3, 4, 5, 6, 22]
 
}
 
</syntaxhighlight>
 
===استخدام الدالة <code>()drop</code> مع المصفوفات: الحالة الثانية  ===
 
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من تسعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم <code>()selector</code>، ثم تستخدم الدالة <code>()drop</code> للحصول على لائحة تضم العناصر التي تختلف نتائج تطبيق الدالة <code>()selector</code>عليها، ولأنّ الدالة <code>()selector</code> ستعيد نفس القيمة (<code>0</code>) على كل العناصر،  فستعيد الدالة <code>()distinctBy</code> عنصرًا واحدًا فقط (العنصر الأول):<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,4,5,2,6,22)
+
    val array = arrayOf(1, 2, 3, 4)
val selector: (Int) -> Int = {it*0}
+
   
println(array.distinctBy(selector)) // [1, 2, 3, 4, 5, 6, 22]
+
    println(array.drop(2)) // [3, 4]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا  ==
 
==انظر أيضًا  ==
* <code>[[Kotlin/collections/distinct|distinct()]]</code>‎: تعيد  <nowiki/>[[Kotlin/List|لائحة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها بدون تكرار مع احترام ظهور تلك العناصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/Array|المجموعة]].
+
* الدالة <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد [[Kotlin/List|قائمة]] تحوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
* <code>[[Kotlin/collections/count|count()]]</code>: تعيد عدد عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] أو [[Kotlin/Array|القاموس]] التي استُدعيت عبرها.
+
*الدالة <code>[[Kotlin/collections/dropWhile|dropWhile()]]</code>‎: تعيد [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
 +
*الدالة <code>[[Kotlin/collections/dropLastWhile|dropLastWhile()]]</code>‎: تعيد [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
 +
* الدالة <code>[[Kotlin/collections/distinct|distinct()‎]]</code>: تحذف العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة.
 +
* الدالة <code>[[Kotlin/collections/elementAt|elementAt()]]</code>: تعيد العنصر الموجود عند فهرس معين في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها.
  
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/distinct-by.html الدالة  drop()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/drop.html صفحة الدالة drop()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 07:44، 8 سبتمبر 2018

تعيد الدالة drop()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.

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

fun <T> Array<out T>.drop(n: Int): List<T> 
fun ByteArray.drop(n: Int): List<Byte> 
fun ShortArray.drop(n: Int): List<Short> 
fun IntArray.drop(n: Int): List<Int> 
fun LongArray.drop(n: Int): List<Long> 
fun FloatArray.drop(n: Int): List<Float>
fun DoubleArray.drop(n: Int): List<Double> 
fun BooleanArray.drop(n: Int): List<Boolean> 
fun CharArray.drop(n: Int): List<Char> 
fun <T> Iterable<T>.drop(n: Int): List<T>

المعاملات

n

عدد صحيح يمثل عدد العناصر المراد حذفها من بداية المصفوفة أو المجموعة المعطاة.

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

تُعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء العناصر n الأولى.

أمثلة

استخدام الدالة ()drop مع المصفوفات

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()drop لحذف أول عنصرين من عناصر هذه المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4)
    
    println(array.drop(2)) // [3, 4]
}

انظر أيضًا

مصادر