نتائج البحث

تجلب الدالة first()‎ أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. إن كانت المصفوفة أو المجموعة التي استُدعيت الدالة first()‎ عبرها فارغة أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستُطلِق الدالة الاستثناء NoSuchElementException. البنية العامة يمكن استدعاء الدالة first()‎ بدون تمرير أية معاملات: fun <T> Array<out T>.first(): T fun ByteArray.first(): Byte fun ShortArray.first(): Short fun IntArray.first(): ...

يحوي الصنف DeprecationLevel مستويات تصف درجات الإهمال (deprecation levels). enum class DeprecationLevel القيم القابلة للعد (Enum Values) WARNING تشير القيمة WARNING إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). ERROR تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). HIDDEN تشير القيمة HIDDEN إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. الخاصيات الموروثة (Inherited Properties) name تمثِّل الخاصية Enum.name اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. ordinal تمثل الخاصية Enum.ordinal ترتيب (ordinal) الثابت المعرف في ...

actual typealias Appendable = Appendable المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.  الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...

تمثل الخاصية MatchResult.destructured‎ نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. تطابق الدالة component1 قيمة المجموعة الأولى، وتطابق الدالة component2 قيمة المجموعة الثانية، وهلم جرًا. البنية العامة open val destructured: Destructured القيمة المعادة تعاد نسخةٌ من الصنف Destructured. أمثلة ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم regex لتفكيك مسارات الملفات إلى ثلاث مُركّبات: المجلد (directory) واسم الملف (fileName) والامتداد (extension)، ثم نعرّف سلسلة نصية باسم fullPath تحتوي مسار أحد الملفات، ثم نستخرج من fullPath مجموعات النتائج عبر استدعاء الدالة ...

تنقص الدالة dec()‎ القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة. البنية العامة operator fun dec(): Byte وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). القيمة المعادة تعاد قيمة من النوع Byte تمثل القيمة المعطاة بعد انقاصها بمقدار 1. أمثلة استعمال الدالة ()inc لانقاص قيمة عددية: fun main(args: Array<String>) { val x = 3 println(x.dec()) // 2 } انظر أيضًا الدالة compareTo()‎: توازن  بين قيمة العنصر الذي استُدعيت ...

تشبه الدالة filterNotNullTo()‎ الدالة filterNotNull()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection). البنية العامة fun <C : MutableCollection<in T>, T : Any> Array<out T?>.filterNotNullTo( destination: C ): C fun <C : MutableCollection<in T>, T : Any> Iterable<T?>.filterNotNullTo( destination: C ): C المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد ...

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

الدوال الموروثة equals تبين الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. hashCode يعيد التابع hashCode()‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. toString يعيد التابع toString()‎ تمثيلًا نصيًا للكائن الذي يُستدعى عبره.

تنسِّق الدالة format()‎ سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها. البنية العامة inline fun String.format(vararg args: Any?): String بيئة التشغيل المطلوبة: JVM. تستعمل format()‎ السلسلة النصية التي استُدعيت معها كسلسلة تنسيق نصية (format string) وتعيد سلسلة نصية ناتجة عن تعويض الوسائط args المعطاة وباستخدام الإعدادات الافتراضية للمحلية (locale). inline fun String.Companion.format( format: String, vararg args: Any? ): String بيئة التشغيل المطلوبة: JVM. تستعمل الدالة format()‎ السلسلة النصية format المُمرّرة كسلسلة تنسيق نصية وتعيد سلسلة نصية ناتجة عن ...

تتحقق الدالة isJavaIdentifierPart()‎ إن كان من المحتمل أن يكون المحرف الذي استٌدعي معها جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف. البنية العامة inline fun Char.isJavaIdentifierPart(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان من المحتمل أن يكون المحرف المعطى جزءًا من مُعرِّف جافا (Java identifier) وليس المحرف الأول من المُعرّف، أو القيمة false خلاف ذلك. أمثلة ...

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

تنسخ الدالة copyOf()‎ كامل المصفوفة التي استُدعيت معها أو جزءًا منها.   البنية العامة inline fun <T> Array<T>.copyOf(): Array<T> inline fun ByteArray.copyOf(): ByteArray inline fun ShortArray.copyOf(): ShortArray inline fun IntArray.copyOf(): IntArray inline fun LongArray.copyOf(): LongArray inline fun FloatArray.copyOf(): FloatArray inline fun DoubleArray.copyOf(): DoubleArray inline fun BooleanArray.copyOf(): BooleanArray inline fun CharArray.copyOf(): CharArray inline fun ByteArray.copyOf(newSize: Int): ByteArray inline fun ShortArray.copyOf(newSize: Int): ShortArray inline fun IntArray.copyOf(newSize: Int): IntArray inline fun LongArray.copyOf(newSize: Int): LongArray inline fun FloatArray.copyOf(newSize: Int): FloatArray inline fun DoubleArray.copyOf(newSize: Int): DoubleArray inline ...

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

تشبه الدالة associateByTo()‎ الدالة associateBy()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.  البنية العامة inline fun <T, K, M : MutableMap<in K, in T>> Array<out T>.associateByTo( destination: M, keySelector: (T) -> K ): M inline fun <K, M : MutableMap<in K, in Byte>> ByteArray.associateByTo( destination: M, keySelector: (Byte) -> K ): M inline fun <K, M : MutableMap<in K, in Short>> ShortArray.associateByTo( ...

يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. data actual class MatchGroup الدوال البانية <init> تنشئ كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.   الخاصيات range تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. value تمثل قيمة مجموعة النتائج التي تم الحصول عليها. الدوال الموروثة equals يبين إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معه. hashCode يعيد الشيفرة ...

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

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

تحوّل الدالة toShort()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Short (عدد قصير). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toShort(): Short حلت الدالة Number.toShort()‎ مكان هذه الدالة. القيمة المعادة يعاد عدد من النوع Short يحوي العدد العشري المضاعف المراد تحويله. أمثلة استعمال الدالة ()toShort لتحويل عدد من النوع Double إلى النوع Short: fun main(args: Array<String>) { val x: Double = 52.7 println(x.toShort()) // ...

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

تحوّل الدالة toFloat()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد عشري (أي من النوع Float). هذا قد يؤدي إلى تدوير العدد المراد تحويله. البنية العامة fun toFloat(): Float حلت الدالة Number.toFloat()‎ مكان هذه الدالة. القيمة المعادة يعاد عدد عشري (من النوع Float) يحوي العدد العشري المضاعف المعطى. أمثلة استعمال الدالة ()toFloat لتحويل عدد عشري مضاعف إلى عدد عشري: fun main(args: Array<String>) { val x : Double = 52.0 print(x.toFloat() )// ...

تتحقق الدالة all()‎ إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا. البنية العامة يمكن استدعاء الدالة all()‎ للمصفوفات من الأنواع المختلفة كما يلي: inline fun <T> Array<out T>.all(predicate: (T) -> Boolean): Boolean inline fun ByteArray.all(predicate: (Byte) -> Boolean): Boolean inline fun ShortArray.all(predicate: (Short) -> Boolean): Boolean inline fun IntArray.all(predicate: (Int) -> Boolean): Boolean inline fun LongArray.all(predicate: (Long) -> Boolean): Boolean inline fun FloatArray.all(predicate: (Float) -> Boolean): Boolean inline fun DoubleArray.all(predicate: (Double) -> Boolean): Boolean ...

تحول الدالة toFloatArray()‎ المصفوفة العامة (أي من النوع Array<Float>‎) أو المجموعة  التي استُدعيت معها مصفوفة من النوع FloatArray. البنية العامة fun Array<out Float>.toFloatArray(): FloatArray fun Collection<Float>.toFloatArray(): FloatArray القيمة المعادة تعاد مصفوفة من النوع FloatArray تحوي جميع عناصر المصفوفة العامة (أي من النوع Array<Float>‎) أو المجموعة المعطاة. أمثلة استعمال الدالة ()toFloatArray لتحويل مصفوفة من النوع Array<Float>‎ إلى النوع FloatArray: import java.util.Arrays fun main(args: Array<String>) { val array: Array<Float> = arrayOf(4.5f, 5.4f, 6.0f) println(Arrays.toString(array.toFloatArray())) // [4.5, 5.4, 6.0] ...

تقتطع الدالة split()‎ المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها وتعيدها في قائمة. البنية العامة fun CharSequence.split( regex: Pattern, limit: Int = 0 ): List<String> inline fun CharSequence.split( regex: Regex, limit: Int = 0 ): List<String> fun CharSequence.split( vararg delimiters: String, ignoreCase: Boolean = false, limit: Int = 0 ): List<String> fun CharSequence.split( ...

تتحقق الدالة isJavaIdentifierStart()‎ إن كان يُسمَح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier). البنية العامة inline fun Char.isJavaIdentifierStart(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان يسمح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier)، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isJavaIdentifierStart()‎ لمعرفة أيُّ المحرفين التاليين يسمح ...

تتحقق الدالة isLowSurrogate()‎ إن كان المحرف الذي استٌدعي معها بديلًا سفليًّا لعدد بتات الترميز الموحد (Unicode low-surrogate code unit). البنية العامة inline actual fun Char.isLowSurrogate(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى بديلًا سفليًّا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isLowSurrogate()‎ لمعرفة أي المحرفيين التاليين هو بديل سفلي لعدد بتات الترميز الموحد: fun main(args: Array<String>) ...

ترتِّب الدالة 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 ...

تزيد الدالة inc()‎ القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة. البنية العامة operator fun inc(): Byte القيمة المعادة تعاد قيمة من النوع Byte تمثل القيمة المعطاة بعد زيادتها بمقدار 1. أمثلة استعمال الدالة ()inc لزيادة قيمة عددية: fun main(args: Array<String>) { val x = 3 println(x.inc() )// 4 } انظر أيضًا الدالة compareTo()‎: توازن بين قيمة العنصر الذي استُدعيت معه والقيمة المُمرّرة إليه ثمَّ ...

تجلب الدالة indexOfLast()‎ فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة indexOfLast()‎ مع المصفوفات والمجموعات والقوائم: inline fun <T> Array<out T>.indexOfLast( predicate: (T) -> Boolean ): Int inline fun ByteArray.indexOfLast( predicate: (Byte) -> Boolean ): Int inline fun ShortArray.indexOfLast( predicate: (Short) -> Boolean ): Int inline fun IntArray.indexOfLast( predicate: (Int) -> Boolean ): Int inline fun LongArray.indexOfLast( predicate: ...

تمثل الخاصية Regex.pattern النمط الذي استعمل في إنشاء التعبير النمطي الذي استُدعي معها. البنية العامة actual val pattern: String القيمة المعادة تعاد سلسلة نصية تمثل النمط الذي استعمل في إنشاء التعبير النمطي المعطى. أمثلة استعمال الخاصية Regex.pattern مع تعبير نمطي لمعرفة النمط الأولي الذي استعمل في إنشائه -باستعمال الدالة Regex()‎-: fun main(args: Array<String>) { val reg = Regex("""-?\d+(\.\d+)?""") print(reg.pattern ) // -?\d+(\.\d+)? } انظر أيضًا الخاصية Regex.options: تمثل مجموعةَ الخيارات التي استُخدمت في إنشاء التعبير ...

يعدُّ الصنف Enum الصنف الأساس لكل الأصناف القابلة للعد (enum classes). إن أردت الاطلاع على معلومات أوسع حول هذه الأصناف، فاقرأ هذا المرجع. abstract class Enum<E : Enum<E>> : Comparable<E> (source) الدوال البانية (Constructors) <init> يعدُّ الصنف Enum الصنف الأساس لكل أصناف الترقيم (enum classes). الخاصيات name تمثل اسم الثابت المعرف في الكائن enum الذي استُدعي معها كما سُمّي أُثناء تعريف هذا الكائن. ordinal تمثل ترتيب (ordinal) الثابت المعرف في الكائن enum الذي استُدعي معها. الدوال clone ترمي هذه الدالة استثناءً لأنّ ثوابت الصنف Enum لا يمكن أن ...

ترتِّب الدالة 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, ...

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

أصبحت الدالة Regex_1 مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility). تنشئ هذه الدالة تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة مع استعمال الخيارات الافتراضية. البنية العامة fun Regex_1(pattern: String): Regex (source) المعاملات pattern سلسلة نصية تمثل النمط الذي سينشأ منه تعبير نمطي. القيم المعادة يعاد كائن من النوع Regex يحتوي على التعبير النمطي pattern بعد ضبطه وفقًا للقيمة الافتراضية للخيارات. انظر أيضًا الدالة Regex()‎: تنشئ تعبيرًا نمطيًا (regular expression) انطلاقًا من السلسلة النصية المُمرّرة إليه. الدالة findAll()‎: تبحث عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة ...

يمثل الصنف Array مصفوفة (مصفوفة Java تحديدًا عند استهداف المنصة JVM). يمكن إنشاء نسخ من هذا الصنف باستعمال الدوال ()‎arrayOf و ()‎arrayOfNulls و ()‎emptyArray الخاصة بالمكتبة القياسية. للمزيد من المعلومات حول المصفوفات، ارجع إلى قسم "المصفوفات" في توثيق الأنواع الأساسية. class Array<T> الدوال البانية <int> تنشِئ الدالة Array()‎ البانية مصفوفةً بحجم size مُحدَّدٍ، حيث يُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة init المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى. الدوال والخاصيات size تمثِّل الخاصيّة size عدد العناصر الموجودة في المصفوفة (array). iterator تعيد هذه الدالة ...

تشبه الدالة filterIndexedTo()‎ الدالة filterIndexed()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.   البنية العامة inline fun <T, C : MutableCollection<in T>> Array<out T>.filterIndexedTo( destination: C, predicate: (index: Int, T) -> Boolean ): C inline fun <C : MutableCollection<in Byte>> ByteArray.filterIndexedTo( destination: C, predicate: (index: Int, Byte) -> Boolean ): C inline fun <C : MutableCollection<in Short>> ShortArray.filterIndexedTo( destination: C, ...

ترمز الدالة toByteArray()‎ جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray. البنية العامة inline fun String.toByteArray( charset: Charset = Charsets.UTF_8 ): ByteArray بيئة التشغيل المطلوبة: JVM. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات charset اسم الترميز المراد تحويل محارف السلسلة النصية المعطاة إليه. القيمة الافتراضية هي: Charsets.UTF_8. القيم المعادة تعاد مصفوفة من النوع ByteArray تحوي ناتج ترميز جميع ...

تمثل الخاصية MatchResult.value السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة للتعبير النمطي. البنية العامة abstract val value: String القيمة المعادة تعاد سلسلة نصية تحوي السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة للتعبير النمطي. أمثلة في الشيفرة التالية، ننشِئ تعبيرًا نمطيًا باسم regex باستخدام التابع Regex()‎، ثم نعرّف سلسلة نصية باسم str، ثم نستخرج منها مجموعات النتائج عبر استدعاء الدالة matchEntire()‎. نستخدم بعدئذٍ الخاصية value لاستخراج السلسلة النصية المُطابقة للتعبير النمطي regex و الموجودة في str: fun main(args: Array<String>) { val pattern = Regex("[a-zA-Z]+([0-9]+)[a-zA-Z]+([0-9]+)[a-zA-Z]+") val str = ...

تتحقق الدالة isJavaIdentifierStart()‎ إن كان يُسمَح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier). البنية العامة inline fun Char.isJavaIdentifierStart(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان يسمح أن يكون المحرف الذي استٌدعي معها المحرف الأول من مُعرِّف جافا (Java identifier)، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isJavaIdentifierStart()‎ لمعرفة أيُّ المحرفين التاليين يسمح ...

تتحقَّق الدالة isNotEmpty()‎ إن كانت المصفوفة أو المجموعة التي استُدعيت معها فارغةً أم لا. تعمل هذه الدالة بشكل معاكس للدالة isEmpty()‎. البنية العامة يمكن استدعاء الدالة isNotEmpty()‎ مع المصفوفات والمجموعات: inline fun <T> Array<out T>.isNotEmpty(): Boolean inline fun ByteArray.isNotEmpty(): Boolean inline fun ShortArray.isNotEmpty(): Boolean inline fun IntArray.isNotEmpty(): Boolean inline fun LongArray.isNotEmpty(): Boolean inline fun FloatArray.isNotEmpty(): Boolean inline fun DoubleArray.isNotEmpty(): Boolean inline fun BooleanArray.isNotEmpty(): Boolean inline fun CharArray.isNotEmpty(): Boolean inline fun <T> Collection<T>.isNotEmpty(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من ...

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

تضبط الدالة set()‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. يمكن الاستعاضة عن هذه الدالة باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل: arr[index]‎ = value البنية العامة operator fun set(index: Int, value: Char) وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة المذكور سابقًا. المعاملات index عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له. value القيمة المراد تعيينها إلى العنصر ذي الفهرس index. أمثلة استعمال الدالة set()‎ لتغيير قيمة العنصر الثاني والثالث إلى 'G' و 'T' على ...

تشبه الدالة filterTo()‎ الدالة filter()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده. البنية العامة inline fun <C> CharSequence.filterTo( destination: C, predicate: (Char) -> Boolean ): C وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف المعطاة. يمرر إلى هذه الدالة محرفٌ ...

تجلب الدالة get()‎ مجموعةً (group) ذات فهرس محدد. البنية العامة abstract operator fun get(index: Int): MatchGroup? وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات index عدد صحيح يمثل فهرس المجموعة المراد جلبها. تفهرس المجموعات بدءًا من العدد 1 وحتى عدد المجموعات في التعبير النمطي؛ المجموعة ذات الفهرس 0 تقابل المطابقة الكلية. القيمة المعادة يعاد كائنٌ من النوع MatchGroup إن كانت المجموعة ذات الفهرس index متطابقة، أو تعاد القيمة null خلاف ذلك. انظر أيضًا الدالة MatchGroup()‎: ...

تحوّل الدالة toTitleCase()‎ المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط. البنية العامة inline fun Char.toTitleCase(): Char وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد الحرف Char المعطى بعد تحويله إلى حرف عنواني. أمثلة تُعرّف الشيفرة الآتية حرفًا باسم x ثم تستدعي الدالة toTitleCase()‎ معه، ثم تطبع الناتج: fun main(args: Array<String>) { ...

يمثل الصنف Byte عددًا صحيحًا ذا إشارة (signed integer) بحجم 8 بت. في بيئة التشغيل JVM، القيم غير المعدومة (non-nullable) لهذا النوع تُمثَّل كقيم للنوع byte الأساسي. class Byte : Number, Comparable<Byte> الدوال compareTo توازن الدالة compareTo()‎ بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية. dec تنقص الدالة dec()‎ القيمة ...

تحول الدالة toChar()‎ القيمة العددية للمحرف الذي استُدعي معها إلى المحرف المقابل (أي من النوع Char). البنية العامة fun toChar(): Char القيمة المعادة يعاد المحرف الذي تساوي قيمته العددية القيمة العددية للمحرف المعطى. أمثلة استعمال الدالة ()toChar مع المحرف 'f': fun main(args: Array<String>) { val x = 'f' print(x.toChar()) // f } انظر أيضًا الدالة toByte()‎ : تحوّل المحرف الذي استُدعي معها إلى عدد من النوع Byte. الدالة toDouble()‎: تحول المحرف الذي ...

يعد الصنف Any الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ Any. open class Any الدوال البانية <int> يعيد التابع Any()‎ نسخةً من الصنف Any الذي هو الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ Any. الدوال equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها. hashCode تعيد الدالة hashCode()‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي ...

تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما. حجم المجموعة يساوي groupCount + 1، إذ يمثل groupCount عدد الفئات (groups) في التعبير النمطي. الفئات مُفهرسة بدءًا من 1 وحتى groupCount، والفئة ذات الفهرس 0 تقابل كل ما تطابق. يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في التعبير النمطي اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة. interface MatchGroupCollection : Collection<MatchGroup?> الدوال get تعيد هذه ...

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

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

تعيد الدالة codePointCount()‎ عدد محارف الترميز الموحد (Unicode code point) الموجودة في مجال مُحدّد من سلسلة نصية. البنية العامة inline fun String.codePointCount( beginIndex: Int, endIndex: Int ): Int منصة التشغيل المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات beginIndex عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال في السلسلة النصية المعطاة. endIndex عدد صحيح يشير إلى فهرس العنصر (لا يدخل ضمن المجال) ...

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

تتحقق الدالة equals()‎ من تساوي السلسلة النصية أو المحرف الذي استُدعي معها مع السلسلة النصية أو المحرف المُمرّر إليها مع إمكانية تجاهل حالة المحارف. البنية العامة actual fun String?.equals( other: String?, ignoreCase: Boolean = false ): Boolean fun Char.equals( other: Char, ignoreCase: Boolean = false ): Boolean المعاملات other سلسلة نصية أو محرف يراد التحقق من تساويها مع السلسلة النصية أو تساويه مع المحرف المعطى. ignoreCase قيمة منطقية تحدد ...

تبدِّل الدالة replaceBeforeLast()‎ سلسلة نصية مكان كل الجزء الواقع قبل آخر ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. البنية العامة fun String.replaceBeforeLast( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String fun String.replaceBeforeLast( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String المعاملات delimiter المحرف أو السلسلة النصية التي يراد استبدال كامل الجزء الواقع قبلها. replacement السلسلة النصية التي ستحل مكان الجزء الواقع قبل ...

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

تتحقق الدالة contains()‎ إن كانت المصفوفة أو المجموعة التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key). يمكن استدعاء contains()‎ مع خريطة بالشكل x in map للتحقق من أنّ العنصر x موجود ضمنها. البنية العامة يمكن استدعاء الدالة contains()‎ مع مصفوفات: operator fun <T> Array<out T>.contains(element: T): Boolean operator fun ByteArray.contains(element: Byte): Boolean operator fun ShortArray.contains(element: Short): Boolean operator fun IntArray.contains(element: Int): Boolean operator fun LongArray.contains(element: Long): Boolean ...

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

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

تعيد الدالة associateBy()‎ خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا عناصر المصفوفة أو المجموعة المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة.  إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة keySelector، فإنَّ الأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بالمصفوفة أو المجموعة الأصليَّة. البنية العامة إن استدعيت الدالة associateBy()‎مع مصفوفة، فستعيد خريطةً (map) ...

تحسب الدالة average()‎ متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها. البنية العامة يمكن استدعاء الدالة average()‎ مع المصفوفات: @JvmName("averageOfByte") fun Array<out Byte>.average(): Double @JvmName("averageOfShort") fun Array<out Short>.average(): Double @JvmName("averageOfInt") fun Array<out Int>.average(): Double @JvmName("averageOfLong") fun Array<out Long>.average(): Double @JvmName("averageOfFloat") fun Array<out Float>.average(): Double @JvmName("averageOfDouble") fun Array<out Double>.average(): Double fun ByteArray.average(): Double fun ShortArray.average(): Double fun IntArray.average(): Double fun LongArray.average(): Double fun FloatArray.average(): Double fun DoubleArray.average(): Double ويمكن استدعاؤها مع المجموعات: @JvmName("averageOfByte") fun Iterable<Byte>.average(): Double @JvmName("averageOfShort") fun Iterable<Short>.average(): Double @JvmName("averageOfInt") fun ...

تحوّل الدالة toUpperCase()‎ المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase). البنية العامة inline actual fun Char.toUpperCase(): Char inline actual fun String.toUpperCase(): String inline fun String.toUpperCase(locale: Locale): String المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). المعاملات locale المحلية المراد ضبطها إلى منطقة جغرافية محددة وأخذها بالحسبان أثناء عملية التحويل. القيم المعادة يعاد المحرف Char المعطى بعد تحويله إلى محرف كبير، أو السلسلة النصية ...

تتحقق الدالة isLowSurrogate()‎ إن كان المحرف الذي استٌدعي معها بديلًا سفليًّا لعدد بتات الترميز الموحد (Unicode low-surrogate code unit). البنية العامة inline actual fun Char.isLowSurrogate(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى بديلًا سفليًّا لعدد بتات الترميز الموحد، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isLowSurrogate()‎ لمعرفة أي المحرفيين التاليين هو بديل سفلي لعدد بتات الترميز الموحد: fun main(args: Array<String>) ...

تحلّل الدالة toFloatOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري. في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. البنية العامة actual fun String.toFloatOrNull(): Float? بيئة التشغيل المطلوبة: Kotlin 1.1. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد عدد من النوع Float يحوي ناتج تحويل السلسلة النصية المعطاة، أو تعاد القيمة null في حال لم تكن السلسلة النصية تمثل عددًا. أمثلة مثالٌ على استعمال ...

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

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

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

تحوّل الدالة toInt()‎ العدد العشري (float) الذي استُدعي معها إلى عدد صحيح (أي من النوع Int). هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toInt(): Int حلت الدالة Number.toInt()‎ مكان هذه الدالة. القيمة المعادة يعاد عدد صحيح (من النوع Int) يحوي العدد العشري المراد تحويله. أمثلة استعمال الدالة ()toInt لتحويل عدد عشري إلى عدد صحيح: fun main(args: Array<String>) { val x : Float = 52.6f ...

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

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

تعيد الدالة toBoolean()‎ القيمة true إن كانت السلسلة النصية التي استٌدعيت معها تساوي "true" مع تجاهل حالة الأحرف، أو تعيد القيمة false. البنية العامة inline actual fun String.toBoolean(): Boolean يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة النصية المعطاة تساوي "true" مع تجاهل حالة الأحرف، أو تعاد القيمة false خلاف ذلك. أمثلة أمثلة على استعمال الدالة toBoolean()‎: fun main(args: Array<String>) { ...

تُنفّد الدالةُ forEach()‎ الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها. البنية العامة يمكن استدعاء الدالة forEach()‎ مع المصفوفات، والمجموعات، والقواميس، والكائنات. inline fun <T> Array<out T>.forEach(action: (T) -> Unit) inline fun ByteArray.forEach(action: (Byte) -> Unit) inline fun ShortArray.forEach(action: (Short) -> Unit) inline fun IntArray.forEach(action: (Int) -> Unit) inline fun LongArray.forEach(action: (Long) -> Unit) inline fun FloatArray.forEach(action: (Float) -> Unit) inline fun DoubleArray.forEach(action: (Double) -> Unit) inline fun BooleanArray.forEach(action: (Boolean) -> Unit) inline ...

ترتِّب الدالة 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, ...

الدوال الموروثة equals تبين الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره. hashCode يعيد التابع hashCode()‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره. toString يعيد التابع toString()‎ تمثيلًا نصيًا للكائن الذي يُستدعى عبره.

تجلب الدالة maxWith()‎ العنصر أو الزوج الأول من المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى. البنية العامة يمكن استدعاء الدالة maxWith()‎ مع المصفوفات و المجموعات والخرائط: fun <T> Array<out T>.maxWith( comparator: Comparator<in T> ): T? fun ByteArray.maxWith(comparator: Comparator<in Byte>): Byte? (source) fun ShortArray.maxWith( comparator: Comparator<in Short> ): Short? fun IntArray.maxWith(comparator: Comparator<in Int>): Int? (source) fun LongArray.maxWith(comparator: Comparator<in Long>): Long? (source) fun FloatArray.maxWith( comparator: Comparator<in Float> ): Float? fun DoubleArray.maxWith( ...

تعيد الدالة dropLast()‎ قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر. البنية العامة fun <T> Array<out T>.dropLast(n: Int): List<T> fun ByteArray.dropLast(n: Int): List<Byte> fun ShortArray.dropLast(n: Int): List<Short> fun IntArray.dropLast(n: Int): List<Int> fun LongArray.dropLast(n: Int): List<Long> fun FloatArray.dropLast(n: Int): List<Float> fun DoubleArray.dropLast(n: Int): List<Double> fun BooleanArray.dropLast(n: Int): List<Boolean> fun CharArray.dropLast(n: Int): List<Char> fun <T> List<T>.dropLast(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر المراد حذفها من نهاية المصفوفة أو المجموعة المعطاة. القيم المعادة تُعاد ...

تشبه الدالة filterIndexedTo()‎ الدالة filterIndexed()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده. البنية العامة inline fun <C> CharSequence.filterIndexedTo( destination: C, predicate: (index: Int, Char) -> Boolean ): C وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة). المعاملات destination كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها. predicate دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف سلسلة المحارف المعطاة. يمرر إلى هذه ...

تستدعي الدالة apply()‎ بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) لها وتُعيد قيمة this. البنية العامة inline fun <T> T.apply(block: T.() -> Unit): T يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة يعاد الكائن المعطى بعد تعديله. أمثلة تستدعي الشيفرة الآتية الدالة apply()‎ عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من ...

تتحقق الدالة isTitleCase()‎ إن كان المحرف الذي استٌدعي معها محرفًا عُنوانيًا (titlecase). تتكون هذه المحارف عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط. البنية العامة inline fun Char.isTitleCase(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف المعطى محرفًا عُنوانيًا (titlecase)، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isTitleCase()‎لمعرفة أي المحارف التالية هو محرفٌ ...

تجلب الدالة substringAfterLast()‎ كل الجزء الواقع بعد آخر ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية.   البنية العامة fun String.substringAfterLast( delimiter: Char, missingDelimiterValue: String = this ): String (source) fun String.substringAfterLast( delimiter: String, missingDelimiterValue: String = this ): String المعاملات delimiter المحرف أو السلسلة النصية التي يراد جلب كامل الجزء الواقع بعدها. missingDelimiterValue السلسلة النصية التي ستعاد في حال لم يكن المعامل delimiter موجودًا ضمن السلسلة النصية المعطاة. القيمة الافتراضية هي: this (أي السلسلة النصية المعطاة نفسها). القيم المعادة ...

تبحث الدالة trimIndent()‎ عن أقل مسافة بادئة (minimal indent) مشتركة بين جميع أسطر السلسلة النصية التي استُدعيت معها، ثم تحذفها من كل الأسطر، وتحذف أيضًا السطر الأول والأخير إن كانا فارغين (blanks)، أي مُكوّنان من مسافات بيضاء (whitespaces) فقط. الجذير بالذكر أن الأسطر الفارغة لا تؤثر في حساب أقل مسافة بادئة مشتركة بين جميع الأسطر. في حال كان هناك سطر غير فارغ ولا يوجد في بدايته أية مسافة بيضاء، فلن يكون هنالك حينئذٍ مسافة بيضاء مشتركة بين الأسطر؛أي أنَّ الدالة ...

تتحقق الدالة isLetter()‎ إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا. البنية العامة inline fun Char.isLetter(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان المحرف (character) المعطى حرفًا أبجديًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isLetter()‎ للتحقق من كون المحرف المراد استعماله حرفًا أبجديًا: fun main(args: Array<String>) { val x = 'a' ...

تتحقَّق الدالة single()‎ من حواية المصفوفة أو المجموعة أو القائمة التي استُدعيت معها عنصرًا واحدًا فقط أو عنصرًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك. البنية العامة إن استدعيت الدالة single()‎ مع مصفوفة أو مجموعة أو قائمة دون تمرير أي معامل، فستتحقَّق من احتواء تلك المصفوفة أو المجموعة أو القائمة على عنصر واحد فقط ثمَّ تعيده. وفي حال كانت تلك المصفوفة أو المجموعة أو القائمة فارغةً أو تحوي أكثر من عنصر واحد، فستطلق الدالة single()‎ استثناءً: fun <T> Array<out T>.single(): T fun ByteArray.single(): ...

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي. interface MatchResult الأنواع Destructured يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. الخاصيات destructured‎ تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. groupValues تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة. groups تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. range تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. value تمثل هذه الخاصية السلسلة النصية المُدخلة، أو ...

تعيد الدالة dropLastWhile()‎ قائمةً تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا. البنية العامة inline fun <T> Array<out T>.dropLastWhile( predicate: (T) -> Boolean ): List<T> inline fun ByteArray.dropLastWhile( predicate: (Byte) -> Boolean ): List<Byte> inline fun ShortArray.dropLastWhile( predicate: (Short) -> Boolean ): List<Short> inline fun IntArray.dropLastWhile( predicate: (Int) -> Boolean ): List<Int> inline fun LongArray.dropLastWhile( predicate: (Long) -> Boolean ): List<Long> inline fun ...

تنشئ الدالة ‎downTo()‎ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. ينبغي أن تكون القيمة الممرَّرة أصغر من القيمة التي استُدعيت معها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا. البنية العامة infix fun Int.downTo(to: Byte): IntProgression infix fun Long.downTo(to: Byte): LongProgression infix fun Byte.downTo(to: Byte): IntProgression infix fun Short.downTo(to: Byte): IntProgression infix fun Char.downTo(to: Char): CharProgression infix fun Int.downTo(to: Int): IntProgression infix fun Long.downTo(to: Int): LongProgression infix fun Byte.downTo(to: Int): ...

تحلّل الدالة toDoubleOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري مضاعف. في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null. البنية العامة actual fun String.toDoubleOrNull(): Double? بيئة التشغيل المطلوبة: Kotlin 1.1. يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد عدد من النوع Double يحوي ناتج تحويل السلسلة النصية المعطاة، أو تعاد القيمة null في حال لم تكن السلسلة النصية تمثل عددًا. أمثلة مثالٌ على ...

يمثِّل الثابت Char.MAX_SURROGATE القيمة القصوى لبديل لعدد بتات الترميز الموحد (Unicode surrogate code unit). البنية العامة const val MAX_SURROGATE: Char انظر أيضًا الثابت Char.MAX_HIGH_SURROGATE: يمثّل القيمة القصوى للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit). الثابت Char.MAX_LOW_SURROGATE: يمثل القيمة القصوى للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابت Char.MIN_HIGH_SURROGATE: يمثل القيمة الدنيا للبديل الأعلى لوحدة اليونيكود (Unicode high-surrogate code unit). الثابت Char.MIN_LOW_SURROGATE‎: يمثل القيمة الدنيا للبديل الأدنى لوحدة اليونيكود (Unicode low-surrogate code unit). الثابت Char.MIN_SURROGATE: يمثل القيمة الدنيا لبديل ...

تبحث الدالة findLast()‎ على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد آخر ظهور له. البنية العامة inline fun <T> Array<out T>.findLast( predicate: (T) -> Boolean ): T? inline fun ByteArray.findLast( predicate: (Byte) -> Boolean ): Byte? inline fun ShortArray.findLast( predicate: (Short) -> Boolean ): Short? inline fun IntArray.findLast( predicate: (Int) -> Boolean ): Int? inline fun LongArray.findLast( predicate: (Long) -> Boolean ): Long? inline fun ...

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

تجمع الدالة reduceRight()‎ بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية.  البنية العامة inline fun <S, T : S> Array<out T>.reduceRight( operation: (T, acc: S) -> S ): S inline fun ByteArray.reduceRight( operation: (Byte, acc: Byte) -> Byte ): Byte inline fun ShortArray.reduceRight( operation: (Short, acc: Short) -> Short ): Short inline fun IntArray.reduceRight( ...

تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما. حجم المجموعة يساوي groupCount + 1، إذ يمثل groupCount عدد الفئات (groups) في التعبير النمطي. الفئات مُفهرسة بدءًا من 1 وحتى groupCount، والفئة ذات الفهرس 0 تقابل كل ما تطابق. يمكن أن يساوي بعض عناصر المجموعة القيمة العدمية (null) في حال كانت الفئة المقابلة في التعبير النمطي اختيارية، ولم يُرصَد أي تطابق من قبل تلك الفئة. interface MatchGroupCollection : Collection<MatchGroup?> الدوال get تعيد هذه ...

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

تنشئ الدالة rangeTo()‎ مجالًا يقع بين المحرف الذي استدعي معها والمحرف المُمرّر إليها. البنية العامة operator fun rangeTo(other: Char): CharRange وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator). المعاملات other المحرف الآخر الذي سيُنشَأ منه المجال. القيمة المعادة يعاد مجالٌ ينحصر بين المحرف المعطى والمحرف other الممرر. أمثلة استعمال الدالة ()rangeTo لإنشاء مجال من المحارف يقع بين المحرف 'a' والمحرف 'd': fun main(args: Array<String>) { val x = 'a' ...

تعيد الدالة filterNotNull()‎ جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمة null. البنية العامة fun <T : Any> Array<out T?>.filterNotNull(): List<T> fun <T : Any> Iterable<T?>.filterNotNull(): List<T> القيم المعادة تُعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمة null. أمثلة تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()filterNotNull لاستبعاد العناصر ذات القيمة null: fun main(args: Array<String>) { val array = arrayOf(1, 2, 3, null, 5, 6) ...

تحلّل الدالة toDouble()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد عشري مضاعف. في حال لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. البنية العامة inline actual fun String.toDouble(): Double يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). القيم المعادة يعاد عدد من النوع Double يحوي ناتج تحويل السلسلة النصية المعطاة. أمثلة مثالٌ على استعمال الدالة toDouble()‎: fun main(args: Array<String>) { println("43.1".toDouble()) // 43.1 println("32.87".toDouble()) ...

تعيد الدالة asDynamic()‎ قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكي (dynamic type)، الذي يُسمَح بإسناده إلى أي متغيّر أو تمريره كمتغيّر وسيط (argument) أيًّا كان نوعه. بيئة التشغيل المطلوبة:  JS البنية العامة inline fun Any?.asDynamic(): dynamic يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). القيم المعادة تعاد قيمة من النوع الديناميكي (dynamic type). انظر أيضًا الدوال المباشرة (inline functions) في لغة Kotlin. مصادر صفحة الدالة ...

تحلّل الدالة toBigIntegerOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigInteger. البنية العامة fun String.toBigIntegerOrNull(): BigInteger? بيئة التشغيل المطلوبة: Kotlin 1.2 ، JVM. تحلّل الدالة toBigIntegerOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع java.math.BigInteger وتعيد الناتج. إن لم تكن السلسلة النصية تمثل عددًا، فستعيد القيمة null. inline fun String.toBigInteger(radix: Int): BigInteger بيئة التشغيل المطلوبة: Kotlin 1.2 ، JVM. تحلّل الدالة toBigIntegerOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع java.math.BigInteger وتعيد الناتج. إن لم ...

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي. interface MatchResult الأنواع Destructured يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. الخاصيات destructured‎ تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. groupValues تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة. groups تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. range تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. value تمثل هذه الخاصية السلسلة النصية المُدخلة، أو ...

تحوّل الدالة toLong()‎ العدد العشري المضاعف (double) الذي استُدعي معها إلى عدد من النوع Long. هذا قد يؤدي إلى تدوير العدد المراد تحويله أو اقتطاع جزءٍ منه. البنية العامة fun toLong(): Long حلت الدالة Number.toLong()‎ مكان هذه الدالة. القيمة المعادة يعاد عدد من النوع Long يحوي العدد العشري المضاعف المراد تحويله. أمثلة استعمال الدالة ()toLong لتحويل عدد من النوع Double إلى النوع Long: fun main(args: Array<String>) { val x: Double = 52.5 println(x.toLong()) // 52 } انظر ...

تشبه الدالة groupByTo()‎ الدالة groupBy()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. البنية العامة إن مُرِّر إلى الدالة groupBy()‎ المعامل destination والمعامل keySelector فقط، فستُجمّع عناصر المصفوفة أو المجموعة المعطاة بحسب المفتاح الذي تعيده الدالة keySelector()‎ المطبقة على كل عنصر من تلك العناصر ثمَّ تضيف الخريطة الناتجة التي تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة إلى المعامل destination. inline fun <T, K, M : MutableMap<in K, MutableList<T>>> Array<out T>.groupByTo( ...