نتائج البحث

يمثل الصنف FloatArray مصفوفةً من الأعداد العشرية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []float. class FloatArray الدوال البانية <init> تنشئ الدالة FloatArray()‎ البانية مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. الدوال get تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set تضبط الدالة set()‎ قيمة عنصر ذي ...

تجلب الدالة take()‎ آخر n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.   البنية العامة fun CharSequence.takeLast(n: Int): CharSequence fun String.takeLast(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف الأخيرة المراد جلبها من سلسلة المحارف المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول سلسلة المحارف، فستعاد كل المحارف الموجودة في السلسلة. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي آخر n محرف من سلسلة المحارف أو السلسلة النصية المعطاة.  أمثلة مثالٌ على استعمال الدالة ()takeLast: fun ...

تحلّل الدالة toInt()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. البنية العامة inline actual fun String.toInt(): Int تحلّل الدالة toInt()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline actual fun String.toInt(radix: Int): Int بيئة التشغيل المطلوبة: Kotlin 1.1. تحلّل الدالة toInt()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. أما في حال كان المعامل radix المعطى أساسًا غير ...

تعيد الدالة Array.iterator()‎ عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. البنية العامة operator fun iterator(): Iterator<T> ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق. القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. أمثلة تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة iterator()‎ لاستخدامه في ...

تعيد الدالة unaryMinus()‎ القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها. البنية العامة operator fun unaryMinus(): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد عدد عشري مضاعف يمثل القيمة السالبة للعدد العشري المضاعف المعطى. أمثلة استعمال الدالة ()unaryMinus لإعادة قيمة سالبة لعدد عشري مضاعف موجب وآخر سالب: fun main(args: Array<String>) { val x: Double = 52.5 val y = x.unaryMinus() println(y) // ...

الدالة reflect()‎ هي واجهة برمجية (API) تجريبية؛ إن استدعيت مع تعبير تعريف دالة (function expression) أو تعبير lambda، فستعيد نسخةً من KFunction تزودنا بالإمكانيات الداخلية (introspection capabilities) لتعبير تعريف الدالة أو تعبير lambda ذاك المعطى وعن معاملاته. ليست جميع الميزات مدعومةً في الوقت الحالي، تحديدًا KCallable.call و KCallable.callBy. البنية العامة fun <R> Function<R>.reflect(): KFunction<R>? منصة التشغيل المطلوبة: JVM. انظر أيضًا الواجهة Function. الدوال من المرتبة الأعلى (Higher-Order Functions) و تعابير Lambdas. مصادر صفحة الدالة ()reflect في التوثيق الرسميّ للمكتبة القياسيّة في لغة ...

تعيد الدالة codePointBefore()‎ المحرف (Unicode code point) الموجود قبل الفهرس المُحدّد. البنية العامة inline fun String.codePointBefore(index: Int): Int منصة التشغيل المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات index عدد صحيح يمثل فهرس العنصر الذي يلي العنصر المستهدف في السلسلة النصية المعطاة. القيم المعادة يعاد عدد صحيح يمثل المحرف الذي يسبق المحرف ذا الفهرس index من السلسلة النصية المعطاة.  أمثلة مثالٌ على استعمال الدالة ()codePointBefore: fun main(args: Array<String>) { ...

تمثل الواجهة Function قيمةً لنوع وظيفي (functional type) -مثل تعبير lambda-، أو دالة مجهولة، أو مرجع دالة. interface Function<out R> إذ يعيد المعامل R نوع الدالة. الدوال الموروثة equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون: hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الدوال الإضافية (Extension Functions) reflect ...

تمثل الخاصية MatchGroup.value قيمة مجموعة النتائج التي تم الحصول عليها. البنية العامة actual val value: String القيم المعادة تعاد قيمة مجموعة النتائج التي تم الحصول عليها. انظر أيضًا الخاصية MatchGroup.range: تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. مصادر صفحة الخاصيّة MatchGroup.value في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

تحول الدالة toLong()‎ العدد الذي استُدعي معها إلى عدد من النوع Long، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ منه. البنية العامة fun toLong(): Long القيمة المعادة يعاد عدد من النوع Long. أمثلة استعمال الدالة ()toLong لتحويل عدد من النوع Byte إلى النوع Long: fun main(args: Array<String>) { val x : Byte = 52 println(x.toLong() )// 52 ...

تتحقق الدالة isNullOrEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو كانت فارغةً. البنية العامة inline fun CharSequence?.isNullOrEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true كانت سلسلة المحارف المعطاة تساوي null أو كانت فارغةً، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isNullOrEmpty()‎: fun main(args: Array<String>) { val str = "hsoub" ...

تضيف الدالة toList()‎ كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر. البنية العامة fun CharSequence.toList(): List<Char> القيم المعادة تعاد قائمة جديدة تحوي جميع محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة toList()‎: fun main(args: Array<String>) { println("Hello, world!".toList()) // [H, e, l, l, o, ,, , w, o, r, l, d, !] println("Hsoub".toList()) // [H, s, o, u, b] println("114".toList()) // [1, 1, 4] } ...

تمثِّل الخاصيّة FloatArray.size عدد العناصر الموجودة في المصفوفة ذات النوع FloatArray. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع FloatArray: fun main(args: Array<String>) { val array = FloatArray(6) print(array.size) // 6 } انظر أيضًا الصنف ‎FloatArray. الدالة FloatArray()‎: تنشئ مصفوفة جديدة من النوع FloatArray (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0.  الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة. الدالة iterator()‎: تنشئ عنصرًا ...

تعكس الدالة reverse()‎ ترتيب عناصر المصفوفة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة reverse()‎ مع المصفوفات: fun <T> Array<T>.reverse() fun ByteArray.reverse() fun ShortArray.reverse() fun IntArray.reverse() fun LongArray.reverse() fun FloatArray.reverse() fun DoubleArray.reverse() fun BooleanArray.reverse() fun CharArray.reverse() ويمكن استدعاؤها مع القوائم المتغيرة (MutableList): fun <T> MutableList<T>.reverse() أمثلة استعمال الدالة ()reverse لعكس ترتيب عناصر قائمة: fun main(args: Array<String>) { var list = MutableList(6) { it } // [0, 1, 2, 3, 4, 5] list.reverse() print(list) ...

تمثل الخاصيّة CharSequence.lastIndex فهرس المحرف الأخير في سلسلة المحارف التي استُدعيت معها. البنية العامة val CharSequence.lastIndex: Int القيم المعادة يعاد عدد صحيح يمثل فهرس العنصر الأخير الموجود ضمن سلسلة المحارف المعطاة، أو تعاد القيمة 1- إن كانت سلسلة المحارف تلك فارغةً. أمثلة استعمال الخاصية CharSequence.lastIndex لمعرفة فهرس العنصر الأخير في سلسلة من المحارف: fun main(args: Array<String>) { val x = "hsoub" print(x.lastIndex) // 4 } انظر أيضًا الدالة ()get: تجلب العنصر ذي ...

تضيف الدالة toCollection()‎ جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها. البنية العامة fun <T, C : MutableCollection<in T>> Array<out T>.toCollection( destination: C ): C fun <C : MutableCollection<in Byte>> ByteArray.toCollection( destination: C ): C fun <C : MutableCollection<in Short>> ShortArray.toCollection( destination: C ): C fun <C : MutableCollection<in Int>> IntArray.toCollection( destination: C ): C fun <C : MutableCollection<in Long>> LongArray.toCollection( destination: C ): ...

تشبه الدالة mapNotNullTo()‎ الدالة mapNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. البنية العامة يمكن استدعاء الدالة mapNotNullTo()‎ مع المصفوفات والمجموعات والخرائط: inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo( destination: C, transform: (T) -> R? ): C inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo( destination: C, transform: (T) -> R? ): ...

تطابق الدالة match()‎ التعبير النمطي المُمرّر إليها في السلسلة النصية التي استٌدعيت معها. البنية العامة inline fun String.match(regex: String): Array<String>? منصة التشغيل المطلوبة: JS. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات regex التعبير النمطي المراد مطابقته مع السلسلة النصية المعطاة. القيم المعادة مصفوفة تحتوي على السلاسل النصية المُطابقة للتعبير النمطي regex في السلسلة النصية المعطاة. أمثلة مثالٌ على استعمال الدالة match()‎: fun main(args: Array<String>) { val str ...

تعيد الدالةunaryMinus()‎ القيمة السالبة المقابلة للعدد العشري (float) الذي استُدعي معها. البنية العامة operator fun unaryMinus(): Float وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد عدد عشري يمثل القيمة السالبة للعدد العشري المعطى. أمثلة استعمال الدالة ()unaryMinus لإعادة القيمة السالبة لعددٍ عشريٍّ موجب وآخر سالب: fun main(args: Array<String>) { val x: Float = 52.5f val y = x.unaryMinus() println(y) // ...

تمثل الخاصية length‎ حجم الكائن StringBuilder (عدد محارفه) الذي استدعي معها. البنية العامة actual val length: Int منصة التشغيل المطلوبة: JS. حلت الخاصية CharSequence.length مكان هذه الخاصية. القيمة المعادة يعاد حجم الكائن StringBuilder (عدد محارفه) المعطى. أمثلة استعمال الخاصية length‎ لمعرفة حجم كائن من النوع StringBuilder: fun main(args: Array<String>) { val sb = StringBuilder("hsoub") println(sb.length) // => 5 } انظر أيضًا الدالة append()‎: تضيف محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder. الدالة toString()‎: تحول الكائن ...

الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره  enumeration constant‎)‎‎)، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone()‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo()‎ بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية ...

توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة abstract operator fun compareTo(other: T): Int وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other الكائن الآخر المراد موازنته مع الكائن المعطى. القيمة المعادة تعاد القيمة 0 إن كانت القيمة المعطاة ...

تحذف الدالة removeSuffix()‎ لاحقة معينة من سلسلة من المحارف أو سلسلة نصية. البنية العامة fun CharSequence.removeSuffix( suffix: CharSequence ): CharSequence fun String.removeSuffix(suffix: CharSequence): String المعاملات suffix سلسلة من المحارف تمثل اللاحقة المراد حذفها. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إزالة اللاحقة prefix منها. إن لم تكن اللاحقة suffix موجودة في بداية سلسلة المحارف أو السلسلة النصية المعطاة، فستعاد نسخة عن سلسلة المحارف أو السلسلة النصية تلك. أمثلة ...

تعيد الدالة next()‎ كائنًا من النوع MatchResult يحوي ناتج المطابقة التالية لتعبير نمطي محدد والذي يبدأ عند الفهرس الذي انتهت عنده آخر عملية مطابقة (أي يبدأ عن المحرف الذي يلي آخر محرف تمت مطابقته). البنية العامة abstract fun next(): MatchResult? القيمة المعادة يعاد كائنٌ من النوع MatchResult يحوي نتائج المطابقة التالية لتعبير نمطي محدد التي تبدأ من الفهرس الذي انتهت عنده آخر عملية مطابقة. أمثلة ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي معه الدالة find()‎ للحصول على مطابقات التعبير النمطي reg ...

 الدوال الموروثة clone يطلق التابع clone()‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo()‎ بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة . equals تبين الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي ...

ترتِّب الدالة sorted()‎ جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة. البنية العامة fun <T : Comparable<T>> Array<out T>.sorted(): List<T> fun ByteArray.sorted(): List<Byte> fun ShortArray.sorted(): List<Short> fun IntArray.sorted(): List<Int> fun LongArray.sorted(): List<Long> fun FloatArray.sorted(): List<Float> fun DoubleArray.sorted(): List<Double> fun CharArray.sorted(): List<Char> fun <T : Comparable<T>> Iterable<T>.sorted(): List<T> القيمة المعادة تُعاد قائمة تضم عناصر المصفوفة أو المجموعة التكرارية المعطاة بعد ترتيبها تصاعديًّا. أمثلة استعمال الدالة ()sorted لترتيب عناصر مصفوفة تصاعديًّا: fun main(args: Array<String>) { val array = ...

يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray الدوال البانية init تنشئ الدالة BooleanArray()‎ البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود ...

تنشئ الدالة rangeTo()‎ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها. البنية العامة operator fun rangeTo(other: Byte): IntRange operator fun rangeTo(other: Short): IntRange operator fun rangeTo(other: Int): IntRange operator fun rangeTo(other: Long): وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد مجالٌ ينحصر بين القيمة التي استدعيت مع الدالة والقيمة الممررة إليها. أمثلة استعمال الدالة ()rangeTo لإنشاء مجال من الأعداد ينحصر بين العدد ...

تعيد الخاصيّة javaClass صنف Java الخاص بالكائن (object) الذي تُستدعى عبره أثناء التشغيل (runtime)، وتُعرَّف هذه الخاصية في جميع الأصناف الفرعيّة (sub-classes) من الصنف Any. البنية العامة inline val <T : Any> T.javaClass: Class<T> يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). القيم المعادة صنف Java الخاصّ بالكائن الذي تُستدعى عبره أثناء التشغيل (runtime). أمثلة تنشِئ الشيفرة الآتية سلسلةً نصيةً باسم a، وتحصل على صنف Java الخاص بها عبر استدعاء ...

تتحقق الدالة isBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط. البنية العامة actual fun CharSequence.isBlank(): Boolean القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء فقط، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isBlank()‎: fun main(args: Array<String>) { val str1 = " hsoub " val str2 = " ...

تحول الدالة toCharArray()‎ المصفوفة العامة (أي التي من النوع Array<Char>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع CharArray. البنية العامة fun Array<out Char>.toCharArray(): CharArray fun Collection<Char>.toCharArray(): CharArray القيمة المعادة تعاد مصفوفة من النوع CharArray تحوي جميع عناصر المصفوفة العامة (أي التي من النوع Array<Char>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toCharArray لتحويل مصفوفة من النوع Array<Char>‎ إلى مصفوفة من النوع CharArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Char> = arrayOf('a', 'b', 'c') println(array.toCharArray().javaClass.kotlin.qualifiedName) // kotlin.CharArray } انظر أيضًا الدالة toBooleanArray()‎: تحول المصفوفة العامة (أي من النوع Array<out Boolean>‎) أو المجموعة  التي استُدعيت معها ...

يمثل الثابت Float.POSITIVE_INFINITY قيمة موجبة لا نهائية (infinity) لعدد عشري (float). البنية العامة val POSITIVE_INFINITY: Float أمثلة استخدام الثابت Float.POSITIVE_INFINITY لطباعة عدد عشري موجب لا نهائي: fun main(args: Array<String>) { println(Float.POSITIVE_INFINITY ) // Infinity } انظر أيضًا الثابت Float.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري (float). الثابت Float.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري (float). الثابت Float.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية (infinity) لعدد عشري (float). الثابت ...

يمثل الثابت Float.NaN قيمة غير عددية (Not a Number) لعدد من النوع Float. البنية العامة val NaN: Float أمثلة استعمال الثابت Float.NaN لطباعة قيمة غير عددية للنوع Float: fun main(args: Array<String>) { println(Float.NaN) // NaN } انظر أيضًا الثابت Float.MAX_VALUE: يمثل أكبر قيمة موجبة نهائية (finite) لعدد عشري (float). الثابت Float.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري (float). الثابت Float.NEGATIVE_INFINITY: يمثل قيمة سالبة لا نهائية (infinity) لعدد عشري (float). ...

تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه. البنية العامة operator fun CharSequence.iterator(): CharIterator وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة مثالٌ على استعمال الدالة iterator()‎: fun main(args: Array<String>) { val str = "Hsoub" val ...

يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. يمكن الاستعاضة عن هذا التابع باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: arr[index]‎ = value البنية العامة operator fun set(index: Int, value: Byte) وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له. value القيمة المراد تعيينها إلى العنصر ذي الفهرس index. أمثلة استعمال التابع set()‎ لتغيير قيمة العنصر الثاني إلى القيمة 98: import java.util.Arrays fun main(args: Array<String>) ...

تعيد الدالة reversedArray()‎ مصفوفةً تضم عناصر المصفوفة التي استُدعيت معها بترتيب معكوس. البنية العامة fun <T> Array<T>.reversedArray(): Array<T> fun ByteArray.reversedArray(): ByteArray fun ShortArray.reversedArray(): ShortArray fun IntArray.reversedArray(): IntArray fun LongArray.reversedArray(): LongArray fun FloatArray.reversedArray(): FloatArray fun DoubleArray.reversedArray(): DoubleArray fun BooleanArray.reversedArray(): BooleanArray fun CharArray.reversedArray(): CharArray القيم المعادة تُعاد مصفوفة تضم عناصر المصفوفة المعطاة بترتيب معكوس. أمثلة استعمال الدالة ()reversedArray لعكس ترتيب عناصر مصفوفة: import java.util.Arrays fun main(args: Array<String>) { var array = arrayOf(0, 1, 2, 3, 4, 5) print(Arrays.toString(array.reversedArray())) // [5, ...

ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): BooleanIterator وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال التابع iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع جميع العناصر: fun main(args: Array<String>) { ...

تحلّل الدالة toShortOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. البنية العامة fun String.toShortOrNull(): Short? الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toShortOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. fun String.toShortOrNull(radix: Int): Short? الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toShortOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. أما في حال كان المعامل radix المعطى أساسًا غير صالح ...

تنشئ الدالة asSequence()‎ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for). البنية العامة fun CharSequence.asSequence(): Sequence<Char> القيم المعادة كائن من الصنف Sequence التي تغلّف سلسلة المحارف المعطاة لاستعمالها في الحلقات التكرارية. أمثلة تعرّف الشيفرة التالية سلسلة نصية باسم str ثم تستدعي الدالة asSequence()‎ معها وتُحيل القيمة المُعادة إلى المتغير seq ثم نطبَع الناتج باستخدام الحلقة التكرارية for: fun main(args: Array<String>) ...

تعكس الدالة reversed()‎  ترتيب محارف سلسلة المحارف أو السلسلة النصية التي استدعيت معها. البنية العامة fun CharSequence.reversed(): CharSequence inline fun String.reversed(): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة بترتيب معكوس. أمثلة مثالٌ على استعمال الدالة ()reversed: fun main(args: Array<String>) { val str = "wikiHsoub" println(str.reversed()) // buosHikiw } انظر ...

تعيد الدالة Array.get()‎ قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]‎ البنية العامة operator fun get(index: Int): T ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر عند الفهرس (index) المُحدَّد في المصفوفة. أمثلة تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة ...

تبحث الدالة findAnyOf()‎ عن أول ظهور لأيٍّ من السلاسل النصية المعطاة في سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.findAnyOf( strings: Collection<String>, startIndex: Int = 0, ignoreCase: Boolean = false ): Pair<Int, String>? المعاملات strings مجموعةٌ من سلاسل نصية يراد البحث عنها ضمن سلسلة المحارف المعطاة. لتجنب الالتباس الناتج عند وجود محارف مشتركة بين السلاسل النصية الموجودة في المعامل strings، فإنّ الدالة findAnyOf()‎ تبدأ من بداية سلسلة المحارف المعطاة ...

يمثل الصنف Boolean قيمة منطقية وهي إما true أو false؛ في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع boolean الأساسي. class Boolean : Comparable<Boolean> الدوال and تجري الدالة and()‎ العملية and المنطقية بين قيمتين منطقيتين؛ خلافًا للمعامل &&، تتحقق هذه الدالة من كلا القيمتين المنطقيتين. compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة ...

تبحث الدالة intersect()‎ عن العناصر المشتركة بين مصفوفتين أو مجموعتين ثمَّ تعيدها في مجموعة. تحافظ المجموعة المُعادة على ترتيب تكرار المصفوفة أو المجموعة الأصلية. البنية العامة يمكن استدعاء الدالة intersect()‎ مع المصفوفات والمجموعات: infix fun <T> Array<out T>.intersect( other: Iterable<T> ): Set<T> infix fun ByteArray.intersect( other: Iterable<Byte> ): Set<Byte> infix fun ShortArray.intersect( other: Iterable<Short> ): Set<Short> infix fun IntArray.intersect(other: Iterable<Int>): Set<Int> (source) infix fun LongArray.intersect( other: Iterable<Long> ): Set<Long> infix fun FloatArray.intersect( ...

تحول الدالة capitalize()‎ الحرف الأول للسلسلة النصية التي استُدعيت معها إلى حرف كبير (uppercase). البنية العامة actual fun String.capitalize(): String القيم المعادة تعاد نسخة من السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، أو تعاد نسخة أخرى من تلك السلسلة النصية إن كان الحرف الأول فيها حرفًا كبيرًا أو كانت السلسلة فارغةً. أمثلة مثالٌ على استعمال الدالة ()capitalize: fun main(args: Array<String>) { println("wiki hsoub".capitalize()) // Wiki hsoub println("Wiki hsoub".capitalize()) // Wiki ...

تحول الدالة toShortArray()‎ المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray. البنية العامة fun Array<out Short>.toShortArray(): ShortArray fun Collection<Short>.toShortArray(): ShortArray القيمة المعادة تعاد مصفوفة من النوع ShortArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toShortArray لتحويل مصفوفة من النوع Array<Short>‎ إلى مصفوفة من النوع ShortArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Short> = arrayOf(4, 5, 6) println(Arrays.toString(array.toShortArray())) // [4, 5, ...

تجلب الدالة get()‎ عنصرًا ذي فهرس محدد من المصفوفة. يمكن الاستعاضة عن هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل: value = arr[index]‎ البنية العامة operator fun get(index: Int): Float وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة الذي ذكرناه آنفًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه. القيم المعادة يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة. أمثلة استعمال الدالة get()‎ لجلب العنصر الثالث من مصفوفة من النوع FloatArray: import java.util.Arrays fun main(args: Array<String>) { val int: (Int) ...

تمثل الخاصية MatchResult.range مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. البنية العامة abstract val range: IntRange القيمة المعادة يعاد مجالٌ من النوع IntRange يمثل الفهارس التي تحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. أمثلة في الشيفرة التالية، ننشِئ تعبيرًا نمطيًا باسم regex باستخدام التابع Regex()‎، ثم نعرّف سلسلة نصية باسم str، ثم نستخرج منها مجموعات النتائج عبر استدعاء الدالة matchEntire()‎. نستخدم بعدئذٍ الخاصية MatchResult.range لاستخراج الفهارس التي تحدد مكان مُطابقة التعبير النمطي regex في ...

توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم Regex ذلك. interface MatchNamedGroupCollection : MatchGroupCollection الإصدار المطلوب: kotlin 1.1. الدوال (Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الدوال الموروثة (Inherited Functions) get تعيد هذه الدالة نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. الخاصيات الإضافية (Extension Properties) indices تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection). الدوال ...

تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). انظر أيضًا القيمة WARNING: تشير إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). القيمة HIDDEN: تشير إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. مصادر صفحة ERROR في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

تستثني الدالة subtract()‎ العناصر المشتركة بين كائنين. تحافظ المجموعة (Set) المُعادة على ترتيب التكرار الخاص بالمجموعة (collection) المعطاة. البنية العامة يمكن استدعاء الدالة subtract()‎ مع المصفوفات والمجموعات التكرارية: infix fun <T> Array<out T>.subtract( other: Iterable<T> ): Set<T> infix fun ByteArray.subtract( other: Iterable<Byte> ): Set<Byte> infix fun ShortArray.subtract( other: Iterable<Short> ): Set<Short> infix fun IntArray.subtract(other: Iterable<Int>): Set<Int> infix fun LongArray.subtract( other: Iterable<Long> ): Set<Long> infix fun FloatArray.subtract( other: Iterable<Float> ): Set<Float> infix ...

تحلّل الدالة toByte()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte. البنية العامة inline actual fun String.toByte(): Byte تحلّل الدالة toByte()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte ثم تعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلق الاستثناء NumberFormatException. inline actual fun String.toByte(radix: Int): Byte بيئة التشغيل المطلوبة:Kotlin 1.1. تحلّل الدالة toByte()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Byte وتعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلق ...

تشبه الدالة mapIndexedNotNullTo()‎ الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة يمكن استدعاء الدالة mapIndexedNotNullTo()‎ مع المصفوفات والمجموعات: inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapIndexedNotNullTo( destination: C, transform: (index: Int, T) -> R? ): C inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo( destination: C, transform: (index: Int, T) -> R? ): C وجود الكلمة المفتاحية inline يدل ...

تُزيِل الدالة dropLast()‎ آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.   البنية العامة fun CharSequence.dropLast(n: Int): CharSequence fun String.dropLast(n: Int): String المعاملات n عدد صحيح يمثل عدد المحارف المراد حذفها من نهاية السلسلة النصية. القيم المعادة تعاد سلسلة نصية أو سلسلة من المحارف تحوي جميع محارف السلسلة النصية أو سلسلة المحارف المعطاة باستثناء آخر n محرف.  أمثلة مثالٌ على استعمال الدالة ()dropLast: fun main(args: Array<String>) { val str = "wiki Hsoub" println(str.dropLast(0)) // wiki Hsoub ...

يوفّر قيما مُرقّمة (enumeration values) لاستخدامها في تعيين خيارات التعابير النمطية. الخاصيات الموروثة (Inherited Properties) name تعيد الخاصية name اسم الثابت من الكائن enum الذي استُدعيت عبره، كما سُمّيت أُثناء تعريف ذلك الكائن. ordinal تعيد الخاصية ordinal ترتيب الثابت من الكائن enum الذي استُدعيت عبره  enumeration constant‎)‎‎)، أي ترتيبها في تصريح الكائن enum،بحيث تأخذ المُركّبة الأولى العدد 0. الدوال الموروثة clone يطلق التابع clone()‎ استثناءً (exception) لأنّ ثوابت enum  لا يمكن أن تُنسخ. هذا التابع يمنع الأصناف من النوع Enum من أن ترِث من الصنفCloneable. compareTo تقارن الدالةcompareTo()‎ بين قيمة العنصر الذي استُدعيت عبره ...

تنسخ الدالة copyOfRange()‎ مجالًا محدَّدًا من المصفوفة التي استُدعيت معها. البنية العامة inline fun <T> Array<T>.copyOfRange( fromIndex: Int, toIndex: Int ): Array<T> inline fun ByteArray.copyOfRange( fromIndex: Int, toIndex: Int ): ByteArray inline fun ShortArray.copyOfRange( fromIndex: Int, toIndex: Int ): ShortArray inline fun IntArray.copyOfRange( fromIndex: Int, toIndex: Int ): IntArray inline fun LongArray.copyOfRange( fromIndex: ...

تنقص الدالة dec()‎ العدد العشري (float) الذي استُدعي معها بمقدار 1 ثمَّ تعيد القيمة الناتجة. البنية العامة operator fun dec(): Float وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Float تمثل القيمة المعطاة بعد انقاصها بمقدار 1. أمثلة استعمال الدالة ()dec لإنقاص عدد عشري بمقدار 1 فقط: fun main(args: Array<String>) { val x: Float = 3.4f println(x.dec()) // 2.4 } انظر أيضًا ...

تعيد الدالة substring()‎ جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة inline actual fun String.substring(startIndex: Int): String inline actual fun String.substring( startIndex: Int, endIndex: Int ): String fun String.substring(range: IntRange): String fun CharSequence.substring(range: IntRange): String inline fun CharSequence.substring( startIndex: Int, endIndex: Int = length ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات startIndex عدد صحيح ...

تبدل الدالة replaceFirst()‎ سلسلة النصية معينة مكان أول مطابقة للتعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها. البنية العامة actual fun replaceFirst( input: CharSequence, replacement: String ): String المعاملات input سلسلة المحارف المراد مطابقتها مع تعبير نمطي واستبدال محتوى المعامل replacement بأول مطابقة لها. replacement السلسلة النصية التي يراد أن تحل مكان المطابقة الأولى للتعبير النمطي المعطى في المعامل input. القيمة المعادة تعاد سلسلة نصية تحوي جميع محتوى المعامل input بعد تبديل السلسلة النصية replacement ...

تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal. البنية العامة inline fun String.toBigDecimal(): BigDecimal منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM. تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع java.math.BigDecimal ثم تعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline fun String.toBigDecimal( mathContext: MathContext ): BigDecimal منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM. تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى ...

تكرِّر الدالة repeat()‎ سلسلة المحارف التي استٌدعيت معها عددًا محددًا من المرات. البنية العامة actual fun CharSequence.repeat(n: Int): String المعاملات n عدد صحيح يمثل عدد مرات تكرار سلسلة المحارف المعطاة. إن أعطيت قيمة سالبة لهذا المعامل، فسيُطلَق الاستثناء IllegalArgumentException. القيم المعادة تعاد سلسلة من المحارف تحوي جميع محارف السلسلة المعطاة بعد تكرارها n مرة. أمثلة مثالٌ على استعمال الدالة ()repeat: fun main(args: Array<String>) { println("Word".repeat(4)) // WordWordWordWord println("Word".repeat(0)) // } مثالٌ آخر على استعمال الدالة ()repeat ...

تعيد الدالة toHashSet()‎ كائنًا من النوع HashSet لجميع عناصر المصفوفة أو المجموعة التي استُدعيت معها. البنية العامة fun <T> Array<out T>.toHashSet(): HashSet<T> fun ByteArray.toHashSet(): HashSet<Byte> fun ShortArray.toHashSet(): HashSet<Short> fun IntArray.toHashSet(): HashSet<Int> fun LongArray.toHashSet(): HashSet<Long> fun FloatArray.toHashSet(): HashSet<Float> fun DoubleArray.toHashSet(): HashSet<Double> fun BooleanArray.toHashSet(): HashSet<Boolean> fun CharArray.toHashSet(): HashSet<Char> fun <T> Iterable<T>.toHashSet(): HashSet<T> القيمة المعادة يعاد كائن من النوع HashSet لجميع عناصر المصفوفة أو المجموعة المعطاة. أمثلة استعمال الدالة ()toHashSet مع مصفوفة مؤلفة من ستة عناصر: import java.util.Arrays fun main(args: Array<String>) { ...

توازن الدالة compareTo()‎ بين عدد عشري مضاعف (double) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. استُبدِل بهذه الدالة الدالة Comparable.compareTo()‎. البنية العامة operator fun compareTo(other: Byte): Int (source) operator fun compareTo(other: Short): Int (source) operator fun compareTo(other: Int): Int (source) operator fun compareTo(other: Long): Int (source) operator fun compareTo(other: Float): Int (source) operator fun compareTo(other: Double): ...

توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. البنية العامة operator fun compareTo(other: Byte): Int حلت الدالة Comparable.compareTo()‎ مكان الشكل السابق من هذه الدالة. operator fun compareTo(other: Short): Int operator fun compareTo(other: Int): Int operator fun compareTo(other: Long): Int operator fun compareTo(other: Float): Int operator ...

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة التي استُدعيت معها. البنية العامة fun CharSequence.withIndex(): Iterable<IndexedValue<Char>> القيم المعادة تعاد مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة المعطاة. أمثلة مثالٌ على استعمال الدالة ()withIndex مع سلسلة نصية ثم إسناد الناتج الذي تعيده إلى المتغير iter، لاستخدامه في حلقة تكرارية for: fun main(args: Array<String>) { val iter = "hsoub".withIndex() for (x in iter) println(x) // المخرجات ...

يمثل الصنف BooleanArray مصفوفةً من القيم المنطقية. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []boolean. class BooleanArray الدوال البانية init تنشئ الدالة BooleanArray()‎ البانية مصفوفة جديدة من الصنف BooleanArray بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة false المنطقية. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة عنصر ذي فهرس محدد موجود ...

تجمع الدالة plus()‎ العدد العشري (float) الذي استُدعي معها مع العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun plus(other: Byte): Float operator fun plus(other: Short): Float operator fun plus(other: Int): Float operator fun plus(other: Long): Float operator fun plus(other: Float): Float operator fun plus(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستُجرَى عليه العملية. القيمة المعادة يعاد عدد عشري يحوي ناتج جمع العدد عشري المعطى مع العدد other ...

يمثل الصنف Boolean قيمة منطقية وهي إما true أو false؛ في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع boolean الأساسي. class Boolean : Comparable<Boolean> الدوال and تجري الدالة and()‎ العملية and المنطقية بين قيمتين منطقيتين؛ خلافًا للمعامل &&، تتحقق هذه الدالة من كلا القيمتين المنطقيتين. compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة ...

تُستخدَم هذه الخاصيّة للحصول على نسخةٍ (instance) من الصنف KClass بحسب نوع التوصيف الحاليّ. البنية العامة val <T : Annotation> T.annotationClass: KClass<out T> القيم المعادة نسخةٌ من الصنف KClass متوافقةٌ مع نوع التوصيف (annotation) الحاليّ. انظر أيضًا التوصيفات (annotations) في لغة Kotlin. الصنف KClass  : أحد أصناف لغة Kotlin والمُستخدَم لإجراء عمليّات التحقُّق الداخليّة (introspection) مثل: isAbstract ومرئية الوصول (visibility) وغيرها. الواجهة Annotation: الواجهة الأساسيّة التي يُعرَّف استخدامها (implemented) ضمنيًا في جميع واجهات التوصيفات (annotation interfaces). مصادر صفحة الخاصيّة annotationClass في ...

تعيد الدالة get()‎ نسخةً من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم المُمرّر إليها متطابقَة. إن لم يكن جلب المجموعات المتطابقة المُسماة (named groups) مدعومًا، فسيُطلَق الاستثناء UnsupportedOperationException. البنية العامة operator fun MatchGroupCollection.get( name: String ): MatchGroup? الإصدار ومنصة التشغيل المطلوبان: JRE8 ،JVM ،Kotlin 1.2 وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيم المعادة تعاد نسخة من الصنف MatchGroup إن كانت المجموعة التي تحمل الاسم name متطابقَةأو تعاد القيمة null خلاف ...

تبدِّل الدالة replaceIndentByMargin()‎ سلسلة نصية جديدة مكان المسافة البادئة (indent) المحددة في المعامل الممرر إليها في السلسلة النصية التي استُدعيت معها. البنية العامة fun String.replaceIndentByMargin( newIndent: String = "", marginPrefix: String = "|" ): String المعاملات newIndent السلسلة النصية التي يراد أن تحل مكان المسافة الفارغة البادئة. القيمة الافتراضية هي: "". marginPrefix  سلسلة نصية غير فارغة تستعمل كمحدد لحدود المسافة البادئة المراد استبدالها. القيمة الافتراضية هي: | (محرف الأنبوب [pipe character]). القيم المعادة تعاد ...

تحول الدالة toDouble()‎ العدد الذي استُدعي معها إلى عدد من النوع Double، وهذا قد يؤدي إلى تقريب العدد. البنية العامة fun toDouble(): Double القيمة المعادة يعاد عدد من النوع Double. أمثلة تعرّف الشيفرة الآتية عددًا باسم x، ثم تستخدم الدالة()toDouble على x، ثم تطبع الناتج: fun main(args: Array<String>) { val x: Byte = 52 println(x.toDouble()) // 52.0 } انظر أيضًا الدالة toByte()‎: تحوّل العدد الذي استُدعي معها إلى عدد من النوع Byte، وهذا قد يؤدي إلى تقريب العدد أو اقتطاع جزءٍ ...

تحول الدالة toPattern()‎ كائنًا من النوع Regex (تعبيرًا نمطيًا) إلى النوع Pattern (نمط). بناءً على ذلك، توفر هذه الدالة وسيلة لاستعمال الكائن Regex في المكان الذي يطلب فيه استعمال الكائن Pattern. البنية العامة fun toPattern(): Pattern المنصة المطلوبة: JVM. القيمة المعادة تعاد نسخةٌ من الصنف Pattern لها نفس السلسلة النصية النمطية (pattern string) والخيارات التي يملكها التعبير النمطي المعطى. أمثلة ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة القيم العددية، ثم يُستدعَى معه الدالة toPattern()‎ لتحويل ذلك التعبير النمطي إلى النمط Pattern: fun main(args: Array<String>) ...

تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصية size مع مصفوفة منطقية يراد معرفة عدد عناصرها: fun main(args: Array<String>) { val array = BooleanArray(4) {it % 2 == 0} println(array.size) // 4 } استعمال الخاصية size لمعرفة إن كانت المصفوفة فارغة أم لا: fun main(args: Array<String>) { ...

تمثل الخاصيّة size‎ عدد العناصر الموجودة في المصفوفة (array). البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يساوي عدد العناصر في المصفوفة المُحدَّدة. أمثلة استخدام الخاصية size مع مصفوفة أعداد صحيحة (integers): fun main(args: Array<String>) {    val arrayOfInt = arrayOf(1, 2, 3, 4, 5)    println(arrayOfInt.size)   // 5 } استخدام الخاصية size مع مصفوفة سلاسل نصية (strings): fun main(args: Array<String>) {    val arrayOfStr = arrayOf("programming","kotlin")    println(arrayOfStr.size)   // 2 } استخدام الخاصية size مع مصفوفة فارغة (empty): fun main(args: Array<String>) {    val emptyArray: Array<Int> = arrayOf()    println(emptyArray.size)  // 0 } انظر ...

يمثل الثابت Double.MAX_VALUE أكبر قيمة موجبة نهائية (finite) لعدد عشري مضاعف (double). البنية العامة val MAX_VALUE: Double أمثلة استخدام الثابت Double.MAX_VALUE لمعرفة أكبر عدد عشري مضاعف موجب يمكن استعماله: fun main(args: Array<String>) { println(Double.MAX_VALUE) // 1.7976931348623157E308 } انظر أيضًا الثابت Double.MIN_VALUE: يمثل أًصغر قيمة موجبة غير صفرية يمكن أن يأخذها عدد عشري مضاعف (double). الثابت Double.NEGATIVE_INFINITY: يمثل قيمة سالبة لانهائية (infinity) لعدد عشري مضاعف (double). الثابت Double.POSITIVE_INFINITY: يمثل قيمة موجبة لانهائية (infinity) لعدد عشري ...

تعيد الدالة takeUnless()‎ الكائن (object) الذي استُدعي معها إن لم يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null بخلاف ذلك. البنية العامة inline fun <T> T.takeUnless(predicate: (T) -> Boolean): T? يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات predicate دالةٌ تطبق على كل كائن من الكائنات المعطاة وتعيد قيمة منطقية مقابلة لكلٍّ منها. القيم المعادة تعيد الكائن الذي استُدعيت عبره الدالة إن لم يكن هذا الكائن ...

تستدعي الدالة let()‎ بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كوسيط (argument) لها وتعيد ناتج التنفيذ. عادة ما تُُستخدم let()‎لمنع الوصول إلى  المتغيرات في مجال الأسماء (namespace) إذ إنّ كل المتغيرات المعرَّفة داخلها لن تكون متاحةً خارج تلك البنية (block). البنية العامة inline fun <T, R> T.let(block: (T) -> R): R يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة ...

تعيد الدالة orEmpty()‎ المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك. البنية العامة يمكن استدعاء الدالة orEmpty()‎ مع المصفوفات والمجموعات والقوائم والخرائط والمجموعات التي من النوع Set: inline fun <reified T> Array<out T>?.orEmpty(): Array<out T> inline fun <T> Collection<T>?.orEmpty(): Collection<T> inline fun <T> List<T>?.orEmpty(): List<T> inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> (source) inline fun <K, V> Map<K, V>?.orEmpty(): Map<K, V> ...

تبحث الدالة findAll()‎ عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين. البنية العامة actual fun findAll( input: CharSequence, startIndex: Int = 0 ): Sequence<MatchResult> تبحث الدالة findAll()‎ عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء ...

تقسِّم الدالة div()‎ العدد العشري المضاعف (double) الذي استُدعي معها على العدد الممرّر إليها ثم تعيد الناتج. البنية العامة operator fun div(other: Byte): Double operator fun div(other: Short): Double operator fun div(other: Int): Double operator fun div(other: Long): Double operator fun div(other: Float): Double operator fun div(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر الذي ستجرى عليه العملية. القيمة المعادة يعاد عدد عشري مضاعف ناتج قسمة العدد العدد العشري المضاعف المعطى على العدد other ...

تجري الدالة xor()‎ العملية xor المنطقية بين قيمتين منطقيتين. البنية العامة infix fun xor(other: Boolean): Boolean وجود الكلمة المفتاحية infix يدل على أنَّ هذه الدالة يمكن استدعاؤها بنمط التدوين الداخليّ (infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً. المعاملات other القيمة المنطقية الأخرى التي ستطبق عليها العملية. القيمة المعادة تعاد قيمة منطقية تكون ناتج إجراء العملية xor على القيمتين المعطيتين. أمثلة استخدام الدالة ()xor لتطبيق العملية xor على قيمتين منطقيتين: fun main(args: Array<String>) { println(true xor false) // ...

تبدِّل الدالة replaceIndent()‎ سلسلة نصية جديدة مكان المسافة البادئة الفارغة (indent) في السلسلة النصية التي استُدعيت معها. البنية العامة fun String.replaceIndent(newIndent: String = ""): String المعاملات newIndent السلسلة النصية التي يراد أن تحل مكان المسافة الفارغة البادئة. القيمة الافتراضية هي: "". القيم المعادة تعاد سلسلة نصية تحوي جميع محارف السلسلة النصية المعطاة بعد تبديل قيمة المعامل newIndent مكان المسافة البادئة الفارغة فيها. أمثلة مثالٌ على استعمال الدالة ()replaceIndent: fun main(args: Array<String>) { val str = " ...

تعيد الدالة mapIndexedNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة. البنية العامة يمكن استدعاء الدالةmapIndexedNotNull()‎ مع المصفوفات والمجموعات: inline fun <T, R : Any> Array<out T>.mapIndexedNotNull( transform: (index: Int, T) -> R? ): List<R> inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull( transform: (index: Int, T) -> R? ): List<R> وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة ...

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها، أو تعيد مُكرّرًا (iterator) يغلّف كل عنصر أنتجه المكرّر (Iterator) المستدعى مع الدالة مع القيمة المُفهرسة أي يعيد القيمة مع فهرسها. البنية العامة يمكن استدعاء الدالة withIndex()‎ مع المصفوفات أو المجموعات التكرارية أو المكرِّرات: fun <T> Array<out T>.withIndex(): Iterable<IndexedValue<T>> fun ByteArray.withIndex(): Iterable<IndexedValue<Byte>> fun ShortArray.withIndex(): Iterable<IndexedValue<Short>> fun IntArray.withIndex(): Iterable<IndexedValue<Int>> fun LongArray.withIndex(): Iterable<IndexedValue<Long>> fun FloatArray.withIndex(): Iterable<IndexedValue<Float>> fun DoubleArray.withIndex(): Iterable<IndexedValue<Double>> fun BooleanArray.withIndex(): Iterable<IndexedValue<Boolean>> fun ...

توازن الدالة compareTo()‎ بين عدد عشري (float) وعدد آخر ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان العدد الأول (العدد الذي استُدعي مع الدالة) أصغر من العدد الثاني الممرر إليها، أو قيمة موجبة إن كان العدد الأول أكبر من العدد الثاني. البنية العامة operator fun compareTo(other: Byte): Int operator fun compareTo(other: Short): Int operator fun compareTo(other: Int): Int operator fun compareTo(other: Long): Int operator fun compareTo(other: Float): Int حلت الدالة Comparable.compareTo()‎ مكان الأشكال السابقة من هذه الدالة. operator ...

تعيد الدالة unaryPlus()‎ العدد العشري المضاعف (double) الذي استُدعي معها. البنية العامة operator fun unaryPlus(): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد العدد نفسه المعطى. أمثلة استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها: fun main(args: Array<String>) { val x: Double = 52.54 println(x.unaryPlus()) // 52.54 } انظر أيضًا الدالة unaryMinus()‎: تعيد القيمة السالبة المقابلة للعدد العشري المضاعف (double) الذي استُدعي معها. الدالة inc()‎ : تزيد العدد العشري المضاعف (double) ...

تعيد الدالة unaryPlus()‎ العدد العشري (float) الذي استُدعي معها. البنية العامة operator fun unaryPlus(): Float وجود الكلمة المفتاحيّة operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator). القيمة المعادة يعاد العدد نفسه المعطى. أمثلة استعمال الدالة ()unaryPlus لإعادة القيمة المستدعاة معها: fun main(args: Array<String>) { val x: Float = 52.54f println(x.unaryPlus()) // 52.54 } انظر أيضًا الدالة unaryMinus()‎: تعيد القيمة السالبة المقابلة للعدد العشري (float) الذي استُدعي معها. الدالة inc()‎ : تزيد العدد العشري (float) الذي استُدعي معها ...

تُعيد الدالة reversed()‎ قائمة تضم عناصر المصفوفة أو المجموعة التي استُدعيت معها بترتيب معكوس. البنية العامة fun <T> Array<out T>.reversed(): List<T> fun ByteArray.reversed(): List<Byte> fun ShortArray.reversed(): List<Short> fun IntArray.reversed(): List<Int> fun LongArray.reversed(): List<Long> fun FloatArray.reversed(): List<Float> fun DoubleArray.reversed(): List<Double> fun BooleanArray.reversed(): List<Boolean> fun CharArray.reversed(): List<Char> fun <T> Iterable<T>.reversed(): List<T> القيم المعادة تعاد قائمة تضم عناصر المصفوفة أو المجموعة المعطاة بترتيب معكوس. أمثلة استعمال الدالة ()reversed لعكس ترتيب عناصر قائمة: fun main(args: Array<String>) { var list = listOf(1, 2, 3, ...

تتحقق الدالة isEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً. البنية العامة inline fun CharSequence.isEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isEmpty()‎: fun main(args: Array<String>) { print("hsoub".isEmpty()) // false print(" ".isEmpty()) // false ...

تمثِّل الخاصيّة CharArray.size عدد العناصر الموجودة في المصفوفة ذات النوع CharArray. البنية العامة val size: Int القيم المعادة يعاد عددٌ صحيحٌ يمثِّل عدد العناصر في المصفوفة المعطاة. أمثلة استعمال الخاصيّة size لمعرفة عدد العناصر الموجود في مصفوفة من النوع CharArray: fun main(args: Array<String>) { val array = CharArray(6) print(array.size) // 6 } انظر أيضًا الصنف ‎CharArray. الدالة CharArray()‎: تنشئ مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا.   التابع ()get: يجلب عنصرًا ذي فهرس محدد من ...

تتحقق الدالة hasSurrogatePairAt()‎ إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) للمحرف ذي الفهرس المُحدّد. البنية العامة fun CharSequence.hasSurrogatePairAt(index: Int): Boolean المعاملات index عدد صحيح يمثل فهرس المحرف الذي سيُتحقَق منه. القيم المعادة تعاد القيمة true إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) عند الفهرس index، أو تعاد القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة ()hasSurrogatePairAt: fun main(args: Array<String>) { ...

تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها. البنية العامة abstract fun subSequence( startIndex: Int, endIndex: Int ): CharSequence المعاملات startIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه. endIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال). القيمة المعادة يعاد الجزء الواقع بين الحرف ذي الفهرس startIndex والحرف ذي الفهرس endIndex في سلسلة المحارف المعطاة. ...

تحسب الدالة rem()‎ باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها. البنية العامة operator fun rem(other: Byte): Int operator fun rem(other: Short): Int operator fun rem(other: Int): Int operator fun rem(other: Long): Long operator fun rem(other: Float): Float operator fun rem(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد باقي عملية قسمة العدد الذي استُدعي مع الدالة على العدد الممرّر ...

تحلّل الدالة toShort()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. البنية العامة inline actual fun String.toShort(): Short تحلّل الدالة toShort()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. inline actual fun String.toShort(radix: Int): Short الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toShort()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. أما في حال كان المعامل radix المعطى أساسًا غير صالح لتحويل السلسلة ...

تجمع الدالة plus()‎ العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج. البنية العامة operator fun plus(other: Byte): Int operator fun plus(other: Short): Int operator fun plus(other: Int): Int operator fun plus(other: Long): Long operator fun plus(other: Float): Float operator fun plus(other: Double): Double وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other العدد الآخر المراد تطبيق العملية عليه. القيمة المعادة يعاد ناتج جمع العدد الممرّر إلى الدالة مع العدد الذي استُدعي ...

تقتطع الدالة slice()‎ جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده. البنية العامة fun CharSequence.slice(indices: IntRange): CharSequence fun String.slice(indices: IntRange): String fun CharSequence.slice(indices: Iterable<Int>): CharSequence inline fun String.slice(indices: Iterable<Int>): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات indices مجال من النوع IntRange أو كائن من النوع Iterable يحدد الجزء المراد اقتطاعه من سلسلة المحارف أو السلسلة النصية المعطاة. القيم المعادة تعاد سلسلة من المحارف أو سلسلة نصية تحوي الجزء المقتطع من سلسلة المحارف ...

تحلّل الدالة toLongOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد طويل. البنية العامة fun String.toLongOrNull(): Long? الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toLongOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا فستعيد القيمة null. fun String.toLongOrNull(radix: Int): Long? الإصدار المطلوب:Kotlin 1.1. تحلّل الدالة toLongOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل. في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. أما في حال كان المعامل radix المعطى أساسًا غير صالح لتحويل السلسلة ...

يمثل الصنف ByteArray مصفوفةً من البايتات. إن كانت منصة التشغيل المستهدفة هي JVM، فيمكن تمثيل نُسَخ هذا الصنف بالشكل []byte. class ByteArray الدوال البانية <int> تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. الخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة ذات النوع ByteArray. الدوال get يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة. iterator ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. set يضبط التابع set()‎ قيمة ...

تحول الدالة toList()‎ المصفوفة أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة. البنية العامة يمكن استدعاء الدالة toList()‎ مع المصفوفات أو المجموعات التكرارية أو الخرائط: fun <T> Array<out T>.toList(): List<T> fun ByteArray.toList(): List<Byte> fun ShortArray.toList(): List<Short> fun IntArray.toList(): List<Int> fun LongArray.toList(): List<Long> fun FloatArray.toList(): List<Float> fun DoubleArray.toList(): List<Double> fun BooleanArray.toList(): List<Boolean> fun CharArray.toList(): List<Char> fun <T> Iterable<T>.toList(): List<T> fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>> القيمة المعادة تعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التكرارية أو جميع أزواج ...