نتائج البحث

تمثل الخاصية 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 ...

تجمع الدالة sumByDouble()‎ جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. الفرق بين الدالة sumByDouble()‎ والدالة sumBy()‎ هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy()‎ عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممررة إلى sumByDouble()‎ عددًا عشريًّا مضاعفًا (double). البنية العامة يمكن استدعاء الدالة sumByDouble()‎ مع المصفوفات والمجموعات: inline fun <T> Array<out T>.sumByDouble( selector: (T) -> Double ): Double inline fun ByteArray.sumByDouble( ...

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

تمثل الخاصية Char.directionality خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها. البنية العامة val Char.directionality: CharDirectionality منصة التشغيل المطلوبة: JVM. القيم المعادة يعاد كائن من النوع CharDirectionality يمثل خاصية الاتجاه في الترميز الموحد للمحرف المعطى. مثال استعمال الخاصية Char.directionality لمعرفة اتجاه عدة محارف: fun main(args: Array<String>) { val x = 'a' val y = 'أ' val z = '4' println(x.directionality) // LEFT_TO_RIGHT ...