نتائج البحث

تبحث الدالة binarySearch()‎ عن عنصر معين في المجموعة أو مجال من المجموعة (Collection) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن comparator وإلا فستكون النتيجة المعادة غير مُحدّدة. إن احتوت المصفوفة على عناصر متساوية، فلا يمكن التوقع أيها سيُعاد. تُعيد الدالة فهرس العنصر المبحوث عنه إن كان موجودًا في المجال المحدَّد؛ خلاف ذلك، فستعيد القيمة السالبة لنقطة الإدراج (‎-insertion point - 1‎)، وهي الفهرس حيث يجب أن يُدرج العنصر حتى تبقى ...

يمثل الصنف Range مجالًا (مجموعة) من القيم لها بداية ونهاية. يمكن إنشاء المجالات باستخدام الصياغة الحرفية بالشكل s..e و s...e ، أو باستخدام التابع الباني new. المجالات المُنشأة باستخدام الصياغة .. تشمل عنصري البداية والنهاية. أما تلك المُنشأة باستخدام الصياغة ... فلن تشمل قيمة النهاية. عند استخدامها كمكرر (iterator)، ستعيد المجالات كل قيمها بالتتابع. (-1..-5).to_a #=> [] (-5..-1).to_a #=> [-5, -4, -3, -2, -1] ('a'..'e').to_a #=> ["a", "b", "c", ...

ترتِّب الدالة sortedBy()‎ جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. البنية العامة inline fun <T, R : Comparable<R>> Array<out T>.sortedBy( crossinline selector: (T) -> R? ): List<T> inline fun <R : Comparable<R>> ByteArray.sortedBy( crossinline selector: (Byte) -> R? ): List<Byte> inline fun <R : Comparable<R>> ShortArray.sortedBy( crossinline selector: (Short) -> R? ): List<Short> inline fun <R ...

ترتِّب الدالة sortedByDescending()‎ جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. البنية العامة inline fun <T, R : Comparable<R>> Array<out T>.sortedByDescending( crossinline selector: (T) -> R? ): List<T> inline fun <R : Comparable<R>> ByteArray.sortedByDescending( crossinline selector: (Byte) -> R? ): List<Byte> inline fun <R : Comparable<R>> ShortArray.sortedByDescending( crossinline selector: (Short) -> R? ): List<Short> inline fun <R ...

تحول الدالة toSortedSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة. البنية العامة يمكن استدعاء الدالة toSortedSet()‎ مع المصفوفات أو المجموعات التكرارية: fun <T : Comparable<T>> Array<out T>.toSortedSet(): SortedSet<T> fun ByteArray.toSortedSet(): SortedSet<Byte> fun ShortArray.toSortedSet(): SortedSet<Short> fun IntArray.toSortedSet(): SortedSet<Int> fun LongArray.toSortedSet(): SortedSet<Long> fun FloatArray.toSortedSet(): SortedSet<Float> fun DoubleArray.toSortedSet(): SortedSet<Double> fun BooleanArray.toSortedSet(): SortedSet<Boolean> fun CharArray.toSortedSet(): SortedSet<Char> fun <T : Comparable<T>> ...

يعيد التابع max أكبر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أمَّا الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مرِّر الوسيط n، فسيعيد التابع مصفوفة تحوي أكبر n عنصر موجود في المصفوفة الأصلية. البنية العامة max → obj max { |a, b| block } → obj max(n) → array max(n) { |a, b| block } → array المعاملات ...

يعيد التابع min أصغر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أما الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مُرِّر الوسيط n، فسيعيد التابع مصفوفةً تحوي أصغر n عنصر موجود في المصفوفة الأصلية. البنية العامة min → obj min {| a,b | block } → obj min(n) → array min(n) {| a,b | block } → array المعاملات ...

ترتِّب الدالة sortedArrayWith()‎ جميع عناصر المصفوفة التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.  البنية العامة fun <T> Array<out T>.sortedArrayWith( comparator: Comparator<in T> ): Array<out T> المعاملات comparator المقارن الذي سترتَّب العناصر وفقًا له. القيمة المعادة تُعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها وفقًا للمُقارِن comparator المعطى. أمثلة استعمال الدالة ()sortedArrayWith لترتيب عناصر مصفوفة وفقًا لناتج طرح قيمة العنصر اللاحق من قيمة العنصر السابق: import java.util.Arrays fun main(args: Array<String>) { val array = arrayOf(1, 9, -3, ...

تعيد الخاصية CASE_INSENSITIVE_ORDER‎ مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان. تذكر أنّ هذا المُقارِن لا يأخذ إعدادات المحلية بالحسبان، وقد تنتج عن استخدامه نتائج غير مرضية في لمحليَّات معينة. البنية العامة val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String> الإصدار المطلوب: JVM. القيم المعادة يعاد مُقارِن (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان. انظر أيضًا الدالة isLowerCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case). الدالة isUpperCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case). الدالة toUpperCase()‎ : تحوّل الحرف أو ...

يتحقق المعامل <=> من تساوي كائنين بين بعضهما بعضًا (يشبه المعامل ==). يُستخدَم من قبل عدّة توابعٍ لموازنة كائناتٍ مثل Enumerable.sort، و Enumerable.max، ...الخ. يجب أن يعيد تنفيذ المعامل <=> إحدى القيم التالية: -1، أو 0، أو 1، أو nil. القيمة -1 تعني أنَّ القيمة الأولى الواقعة على يسار المعامل أصغر من القيمة الأخرىالواقعه على يمينه. والقيمة 0 تشير إلى أنَّ القيمتين متساويتان، والقيمة 1 تشير إلى أنَّ القيمة الواقعه على يساره أكبر من القيمة الواقعة على يمينه. أخيرًا، تعني ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كان العدد الواقع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر الواقع على يمينه على التوالي. هذا المعامل هو أساس عمليات الموازنة في الصنف Comparable. إذا كانت القيمتان غير قابلتين للمقارنة، فستُعاد القيمة nil. البنية العامة int <=> numeric → -1, 0, +1, or nil  القيمة المعادة يعاد العدد الصحيح ‎-1 أو 0 أو ‎+1 إذا كان العدد int أصغر من أو يساوي أو أكبر ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كان العدد العشري الواقع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر الواقع على يمينه على التوالي. هذا المعامل هو أساس عمليات الموازنة في الصنف Comparable. إذا كانت القيمتان غير قابلتين للموازنة، فستُعاد القيمة nil. البنية العامة float <=> real → -1, 0, +1, or nil  القيمة المعادة يعاد العدد الصحيح ‎-1 أو 0 أو ‎+1 إذا كان العدد float أصغر من أو يساوي أو ...

الدالة Array.prototype.sort()‎ ترتِّب عناصر المصفوفة وتغيّر المصفوفة الأصلية وتُعيد المصفوفة المُعدَّلة، وليس من الضروري أن يكون الترتيب «ثابتًا»، وخوارزمية الترتيب الافتراضية المستخدمة ستُرتِّب العناصر اعتمادًا على رموز يونيكود. الوقت والذاكرة التي تستهلكها عملية الترتيب لا يمكن تحديدها بدقة لأنها تعتمد على المتصفح ونظام التشغيل... var fruit = ['cherries', 'apples', 'bananas']; fruit.sort(); // ['apples', 'bananas', 'cherries'] var scores = [1, 10, 21, 2]; scores.sort(); // [1, 10, 2, 21] // لاحظ أنَّ العدد 10 يأتي قبل 2 // ذلك لأنَّ "10" هو ناتج دمج المحرفين ...

تجلب الدالة min()‎ أصغر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun Array<out Double>.min(): Double? fun Array<out Float>.min(): Float? fun FloatArray.min(): Float? fun DoubleArray.min(): Double? fun Iterable<Double>.min(): Double? fun Iterable<Float>.min(): Float? fun <T : Comparable<T>> Array<out T>.min(): T? fun ByteArray.min(): Byte? fun ShortArray.min(): Short? fun IntArray.min(): Int? fun LongArray.min(): Long? fun CharArray.min(): Char? fun <T : Comparable<T>> Iterable<T>.min(): T? الإصدار المطلوب: Kotlin 1.1. القيم المعادة يُعاد أصغر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو ...

تجلب الدالة max()‎ أكبر عنصر في المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun Array<out Double>.max(): Double? fun Array<out Float>.max(): Float? fun FloatArray.max(): Float? fun DoubleArray.max(): Double? fun Iterable<Double>.max(): Double? fun Iterable<Float>.max(): Float? fun <T : Comparable<T>> Array<out T>.max(): T? fun ByteArray.max(): Byte? fun ShortArray.max(): Short? fun IntArray.max(): Int? fun LongArray.max(): Long? fun CharArray.max(): Char? fun <T : Comparable<T>> Iterable<T>.max(): T? الإصدار المطلوب: Kotlin 1.1. القيم المعادة يُعاد أكبر عنصر في المصفوفة أو المجموعة المعطاة، أو القيمة null إن كانت تلك المصفوفة أو ...

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T> الدوال compareTo توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة ...

الأصناف التي ترث من الواجهة Comparable تملك ترتيبًا إجماليًّا مُعرَّفًا بين نُسخِها. interface Comparable<in T> الدوال compareTo توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. الدوال الموروثة equals تحدد الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة ...

تجلب الدالة maxBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. البنية العامة inline fun <R : Comparable<R>> CharSequence.maxBy( selector: (Char) -> R ): Char? وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات selector دالةٌ تطبَّق على كل محرف من محارف السلسلة المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له. القيم المعادة يعاد المحرف من السلسلة المعطاة والذي أعطى أكبر قيمة عند تطبيق الدالة selector عليه، أو ...

تجلب الدالة minBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه. البنية العامة inline fun <R : Comparable<R>> CharSequence.minBy( selector: (Char) -> R ): Char? وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات selector دالةٌ تطبَّق على كل محرف من محارف السلسلة المعطاة. يمرر إليها المحرف، وتعيد قيمة مقابلة له. القيم المعادة يعاد المحرف من السلسلة المعطاة والذي أعطى أصغر قيمة عند تطبيق الدالة selector عليه، أو ...

ترتِّب الدالة sortDescending()‎ المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تنازليًّا.  البنية العامة يمكن استدعاء الدالة sortDescending()‎ مع المصفوفات والقوائم المتغيرة:  fun <T : Comparable<T>> Array<out T>.sortDescending() fun ByteArray.sortDescending() fun ShortArray.sortDescending() fun IntArray.sortDescending() fun LongArray.sortDescending() fun FloatArray.sortDescending() fun DoubleArray.sortDescending() fun CharArray.sortDescending() fun <T : Comparable<T>> MutableList<T>.sortDescending() أمثلة استعمال الدالة ()sortDescending لترتيب عناصر مصفوفة تنازليًّا: import java.util.Arrays fun main(args: Array<String>) { val array = arrayOf(1, 9, -3, 7, 5, 6) array.sortDescending() print(Arrays.toString(array)) // [9, ...